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Organization a problem? 

Look what Sensible Software is doing for you... 




fa 



Here is a last and friendly utility to organize the files on your 
diskettes using DISK ORGANIZER. You can order the files on 
a diskette not only alphabetically, but in any order you want, 
TITLES can be entered, describing a file or group of files on 
the diskette. These TITLES may be entered in normal, in- 
verse, flashing, and lower case letters. All work is done on a 
RAM version of the Directory; .so if you decide the. changes 
you made are not correct, you can simply abort the process 
and keep the old catalog. Since DISK ORGANIZER.works 
on a RAM version of the Directory, disk access is kept to a 
minimum; hence, DISK ORGANIZER is extremely fast. 
The following functions are also included: 

• DYNAMIC DISPLAY of ail He names in the Directory 

• RENAMING the "HELLO" program. 



• A SIMULATED DATA] ,OG to show the modified Directory 
before it is written to the Diskette. 

• ALPHABETIZING Che file names. 

• UNDELETING deleted files, 

• PURGING deleted tiles. 

• RENAMING tiles (with the same character input options as 
TITLING. 

■ LOCKING and UNLOCKING {some or all) Hes. 

• DELETING fife, 

■ DELETING DOS for increased data storage. 

• A powerful SMART KEY to automatically locate the next, valid 
He name for any specified operation. 

DISK ORGANIZER , . . Apple II or Apple II Pics with 
48K and one or more Disk Drives . . . $30.00 





Is inter-disk travel and 

Intra-disk file manipulation 

causing difficulties? 

Then SUPER DISK COPY is for YOU! 

Super Disk Copy is much more than just another copy 

program. It's practically a 'mini-DOS' in itself. Super Disk 

Copy is completely menu driven and works with DOS 3. 1 , 

3.2, and 3.3. Files may even be transferred from one DOS to 

another (example: DOS 3.3 to DOS 3.2). Super Disk Copy 

makes the conversion to DOS 3.3 less painful. After seeing 

Super Disk Copy, you will agree it-is the best copy program 

on the market! Among the many features are: 

• Wildcards may be entered anytime a tile is used. They allow both 
automatic or user verification of the file Iiandiing. (Example: to 
copy file names that start with Apple', you would enter Apple' = ')■ 

• COPY single files (Applesoft, Integer, Text. Binary. Relocatable), 

• COPY DOS; 

• COPY ENTIRE DISK. Super Disk Copy uses a unique technique 
lor fast copying. 

• A BRUTE KORCE COPY made for Pascal, FORTRAN, and CP.'M 
diskettes. 
• An optional rearrangement of files so that they occupy 

contiguous sectors lor improved access time. 

• UNDELETE deleted files. 

• A PLOT of disk usage. 

• FIX file sizes. Make sure your valuable files are protected 
and unused sectors are available. 

• DELETE DOS. Frees up extra space on your diskettes. 

• ALPHABETIZE file names in directory. 
• REPLACE illegal characters in file names. 

" Optional 'INTT of copy diskette. 

LOCK or UNLOCK files and much, MUCH more. . . 

SUPER DISK COPY was one of only two programs to 
receive a rating of 100 in PRICE/USEFULNESS RATIO in 
THE BOOK OF APPLE COMPUTER SOFTWARE 1982. 
They said 'This is a definite MUST HAVE utility package" 
48K and DISK II required. . .S30.00 
For a complete catalog send $ 1 .00. refundable with your first purchase. 



If you have a large software 
collection and have problems locating 
specific programs or you need to 
be reminded of what they do... then 
you need MULTI-DISK CATALOG 

Multi-Disk Catalog is designed specifically for keeping track of 
the contents .of the APPLE diskette library. The resulting 
master catalog can be sorted, searched, and printed. Multi 
Disk Catalog is entirely menu driven, easy to use, and very- 
fast. Some of the unique features included are: 

• Works with 13 and 16-sectur formated diskettes (DOS 3. \, 3.2 
and 3.3! Diskettes from either type DOS can be added to the same 
data-base. used. 

• You assign the volume identification numl^er (range 1 to 9?^: 
there is no need lo INfT each of your disks with a unique volume 
number. 

• A 2 letter classification code can be added lo each tile name. The 
classifications are retained when tiie disK volume is updateo. 

• Multi-key sorting. Up to 3 keys may be selected for sortliKi the He 
names. The sort keys include disk number, file name, classilicatiot i 
file type, and file size. 

• Multi-Disk Catalog is written entirely in machine langudoe ;-e n s 
very fast, 

• A powerful search mask can be used to find a tile name or lUitif* 
ol He names. 

• Multi-Disk Catalog supports special printer interlaces. 
■ Both sides ol a diskette may be entered under the same disk 

number. 

• Titles may be entered for each diskette and much more! 

'There is no doubt about it, this is the best and most 
versatile master catalog program available"— THE BOOK OF 
APPLE COMPUTER SOFTWARE 1982. 
48K and one Disk Drive required . . . $25 JW 

Sensible Software 

66 19 Perham Drive Depl. H ■ Wat Bloomteld, Michigan 48033 • (313} 399-8877 
Visa and MasterCard welcome, please add Si 25 postage and handling per diskette. 
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Entire contents copyright 1982 by 
SOFTKEY Publishing. All rights reserved, 
Copying done for other than personal 
or internal reference (without the 
express written permission from the 
publisher) is prohibited. 

The editorial staff assumes no liability 
or responsibility for the products adver- 
tised in this magazine. And opinions 
expressed by the authors are not neces- 
sarily those of HARDCORE Computing or 
Softkey Publishing. 

Address all editorial, advertising and 
subscription inquiries to the proper 
dept., HARDCORE Computing, PO. Box 
44549, Tacoma, WA 98444. Return post- 
age must accompany all manuscripts, 
drawings, photos, disks, or tapes if they 
are to be returned, No responsibility 
can be assumed for unsolicited manu- 
scripts, We suggest you send only cop- 
ies. 

Apple usually refers to the Apple II or II 
Plus computer and is a trademark of 
Apple Computers, Inc, 



Subscriptions 



HARDCORE Computing is published 
quarterly by SoftKey Publishing. One 
year subscription rates (for 4 issues and 
4 updates) are: 

U.S.A , , ■ ■ $20 

Canada S29 

Mexico $32 

S, America $38 

all others $42 

All foreign subscriptions must be in 
U.S. funds and prepaid. No credit 
cards, yet. 

DOMESTIC DEALER RATES sent upon 
request, or call [206) 531-1684. 

UPDATES will focus on the subject of 
Softkeys, "How to make backup copies 
of so-called uncopyable diskettes." 
Updates are available only to sub- 
scribers and are not sold in stores. 

If HardCore is not published on sche- 
dule, your subscription will still be for 4 
issues and 4 updates regardless of the 
time it takes to fulfill that order. 




ESQUIRE, Jan. 1982 

"Secrets of the Software Pirates" by 
Lee Gomes 

11 . . .Software houses saw Locksmith 
as the start of an open season on their 
products. They expressed their dis- 
pleasure to the owners of the computer 
magazines, most of whom obliged by 
refusing to run Alpert's ads. When some 
Apple enthusiasts in Washington State 
heard about the boycott, they con- 
cluded it was nothing but censorship 
and another example of the maga- 
zines' ignoring the average Apple user 
to placate their advertisers. So they 
started their own publication, HARD- 
CORE COMPUTING, which with its first 
issue came to play the role of icono- 
clastic underground magazine battling 
the industry's stodgy straight press." 



TIME, Feb. 8, 1982 
"Roaming HUech Pirates" 

11 . , , HARDCORE COMPUTING, a small 
magazine in Tacoma, Wash., warns 
pirates about the latest technology that 
companies are using against them." 



- Personally, I was amazed at how 
TIME magazine confused and mixed up 
the subject of software piracy. In that 
small sidebar on page 61, they con- 
fused two quite different "pirates 1 : the 
companies who pirate from each other, 
and users who make copies, Perhaps 
one day TIME will take time to print the 
user's side of this issue instead of the 
well-publicized complaints of a few soft- 
houses who still admit that SOFTWARE IS 
A BOOMING BUSINESS! 
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If you *m {!>« frost recent version of a previcusiy published program, or if 
Ate \m7to lUt h*ft the tin or desire to type in tJMj listing, you nay be 

mi to plirfclfaVi the program frc-n the Software Library. 



ograf 
follow these steps: 



iJee if it's mjMle by checking the list show) below. 
2.Jirite the charge for that program. For Applesoft BASIC program, there 
"nsv also be a compiled version available for an extra charge. 
y«tnbiU«h if available is extra, For Binary program, source code is 
probably available, so ask for it. 
5,letjj the charges, -idd in the cisk/ihippinn/hanflling charge, and fill in 
the o'-d^r &*rjsk;, incl'jae the cfifefefe or money order in U.S. funds and iaii 
to: KPEMe' iSFJlfiSE LiSSfift'Y 
30?? €3 
-'.r.. Bos 44540 
lac-c^a, w£ &mi 

CHAROES LISTED IH THE ORDER FQRH ARE FOR U.S. AMD CANADA ONLY. FOR 
FMEI6N ORDERS, PLEASE ASK FOR THE PROPER SHIPPING CHAROES. 

OUR DISKETTES ARE NOT COPY -PROTECTED AW HE ENCOURAfiE YOU TO LET OTHER COHPU- 

immSmviSrStnmt mm re help compensate the authors 
B¥ TEL FciWMffi SiPSSJRVTiTraUri ™ » care of 

= "prd8rF"' PRoiiftM BocumIn- cohpileB 

LAN6UA6E CODE NAME ALONE TATI0N |P JH« 



A-soft* 

A-50ft» 



tHMIC 

U-002B 



DiskEdit 2.7 
DiskView 2.0 



Updated versions 

* 5.08 * 2.80 
f 4J0 t 1.00 






Integer 
A-soft 



S-001 
S-802 



f ros issue # 1 

Hi -Res Ink Slots free 

Hi-Res Ink Blots free 



none 
none 



A-soft* A-Ml 

A-soft 8-001 

A-soft 6-082 

A-soft 6-003 



f rD » issue 

Artist's Easel * 3.08 
Amber's Ts * 2.00 
Text Invaders 2.8 * 2.00 
Relief Mapper 1.0 * 1.08 



* 2 



f none 
J none 
t none 
* none 



none 
none 



$ none 
$ none 
t 2.80 
i 1.00 



A-soft 6-004 

A-soft* 6-005 

A-soft 1 U-003 

A-soft (1-004 



f rD i issue i 

Has Editor 2.8 * 2.88 
Zyphyr Hars 2.0 * 1.08 
Senu 2.1 * 2.W 
IQB i 1.80 



t none 
* none 
t none 
$ none 



2.00 
1.08 
none 
none 



Assembly 0-805 HyperDQS 1.8 * 3.88 *_n°5____*__*™!_ *. 



SUBTOTAL *. 



ADD Diskette, Shipping and Handling Charge * i 
TOTAL I .. 



00 



Name __. 

Address 

City ... 



State 



"P _ 



NOTICE: Prices can change nith each nen issue of HardCpre Computing. You Jill 
be notified if the enclosed funds do not cover the new prices. Please allow 4 to 
6 iteefcs for delivery. Be sure to make an i •■ed i a *f _^*^_|f P_^??V^ 

Assembly 3 source code * = some machine code included in BASIC code. 
Compiled A-soft version created by using TASC, by Mic roso f t 
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Dear Sirs, 

Please enter my subscription to the above 
aadress 
RS 

I would very much lite back issues. 
Stephen G. Wozniak 
Los Gatos, CA 



in bad taste 



Dear Sir: 

I agree with Nibble. The ad on the back of 
Update 2,1 is "too suggestive." Moreover it's 

In bad taste. 

I do, however, appreciate the articles In 
your magazine. 

Although it's nice to receive a timely 
"Upaate," they are going to be hard to keep 
track of. I'd Just as soon you save them up 
and put them in a quarterly magazine. 

Bob Britton 

Spring, TX 



blanketiblank 



Gentlemen: 

I can't stand still for George Blank's letter to 
you (p37, Hardcore 2,0), His putdown (how 
do you Justify $20...) is unreasonable, but con- 
sider the source. It's a matter of content, not 
weight. I've learned much more real hard 
Apple lore from just two issues of HarOcore 
than from several years' worth of subscrip- 
tions to CC! 

Mr. Blank comments on the lack of profit- 
ability In the software business. Let's look at 
profits vs. quality The good stuff makes 
money. Ask Ken Williams (who apparently 
finds Hardcore pornographic) whether he 
makes money I The people who go bankrupt 
are those who don't (or can't) develop a 
solid, functional, well-engineered product 
which meets a real need, and is properly 
merchandized, distributed and supported. 
All the copy- protection in the world isn't 
going to save a poor product. And the avail- 
ability of backup methods isn't going to kill a 
superior product (witness VisiCalcl). 

Knowledge of the Apple II computer is 
essential to the development of good soft- 
ware. Hardcore meets a real need in dissem- 
inating vital information not addressed 
elsewhere. Keep it up! 

Harry E. Brawley, Jr. 

Weston. MA 



tempting trap 



Dear Mr. Haight; 

I reaO with interest your magazine. Hard- 
core Computing and I have decided to 
respond in three ways: a subscription 
request, a letter to the editor, and a sugges- 
tion on a column to be used in Hardcore 
Computing. 



I agree with your basic premises In your 
magazine, but in the future I would appreci- 
ate you getting down to the business of sup- 
plying more information about the Internals 
of computing with an Apple Computer. 

While it is obviously Illegal to restrain trade 
by black-balling the advertisement of bit- 
copiers, I feel that your tendency to try to 
retaliate by accusing those people of das- 
tardly deeds accomplishes very little, except 
getting them more excited about trying to 
stop you. 

As the Apple computer showed the world 
by beating the big systems at getting infor- 
mation to the people sooner and more effec- 
tively I think that the people who got us this far 
will continue (or others like them), 

I applaud your continued efforts at getting 
the information about programs out to every- 
one. I agree, too, that the people who put out 
a great deal of effort to generate that Infor- 
mation should be compensated for it. 

I sincerely hope, however, that you do not 
fall into a tempting trap of assuming that any- 
one can decide what a fair compensation 
ought to be. No matter what the current 
social trends are, no one, absolutely no one, 
can determine what Is right for someone 
else. 

I believe the current copyright laws go a 
long way towards protecting the rights of 
both sides of the software problem. Reason- 
ableness must prevail now in the implemen- 
tation of that law. Perhaps there Is room for 
modification so that consumers can be 
inside of the law, but I don't think the Jury Is In 
on that yet. 

Sincerely, 

Bruce Jorgensen 

Richland, WA 



likes 'n dislikes 
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Dear Editor, 
I applaud: 

* 'Hardcore Magazine, 

* * Bit Copy programs, 

* ' Penguin Software for their new "no protec- 
tion policy," 

"the President of Apple Computer for his 
statement on ending locked software in the 
inOustry, 

' ' ana all others in that vein. 
I detest: 

* 'censorship In the magazines, 

* "and those individuals and companies that 
try to force their attitudes about locked soft- 
ware on the end user's, 

* 'Apple computer's new policy of "only over 
the counter sales." 

In the end the competition of a completely 
non-censored competitive market-place will 
prevail. The sooner this happens, the more 
the computing public will benefit from better 
and more software/hardware, 

I would like to see some in-depth articles 
about using hardware In making back-up 

HARDCORE COMPUTING 3.6 



copfes: IE wiring disk drives back to back, 
toadlng programs in expanded RAM then 
dumping back to disks or other methods that 
you know. 

Keep up the good work. 

Dale Hurd 

Yakima, WA 



beyond belief 



Dear Hardcore, 

I recommend Sex-Rated for the Garbage 
Award. It is a do-nothing disk with crude 
graphics, about the 2nd grade, restroom- 
wall quality 

Next to my Apple, I like Sex best. Explicit pic- 
tures do not offend me either. But, this is 
beyond belief. Not only Is it poor quality 
graphics, a minimum of animation, and in 
very poor taste, it unnecessarily exercises 
your disk drive to obtain the "Sounds of Sex." I 
give it a big fat -1 3 on the ratings 

John Bouchillon 

St. Charles, MO 



a buck a copy 



Gentleman; 

Here's S3 for letting me copy and use; 

a. DiskEdit 2.3 

b. Disk View 

c. Data Write 

How can I get instructions on how to use 
these programs? 

You gave these three programs to Dick Pes- 
chke. President of Apple-Dayton, several 
months ago when he visited you. During our 
Jan. meeting Dick told us about what you're 
trying to do. how, and why. Very Impressivel 
Dr. John B. Matthews, our Vice-President, has 
also spoken out strongly in support of your 
activities and encouraged us to support you. 
I Intend to do so. 

I appreciate your publishing "unpro- 
tected" programs and trusting us to forward 
whatever you ask If we like the programs 
enough to copy and use them. That's a rea- 
sonable approach and the cost is certainly a 
bargain. I hope other software publishers will 
follow your lead. 

I wish you continued success. 

Sincerely, 

G. Adams 

WPAF8, OH 



cp/m attitude 



Sirs: 

Enclosed please find a copy of an 
announcement that was printed in INFO- 
WORLD Oct. 19, 1981, This is an indication of 
the attitude of the CP/M users toward copy- 
protection of the programs that we use. 

HARDCORE COMPUTING 3,0 ~~ 



I cannot believe that the CP/M users are 
more honest or intelligent than Apple users; 
however, they do insist that they can make as 
many back-up copies of a program, or mod- 
ify it to suit their needs as necessary. 

it is soon obvious to anyone using an Apple 
for business, as I do, that the 5 1/4 inch disks 
just do not do the job. Even a pair of 8 inch 
drives In single density is doing it the hard 
way 

Copy-protected programs do not allow 
the user to down-load to the 8 inch drives, so 
it is for this reason that all of my business soft- 
ware runs on my Apple under CP/M. 

Possibly, if enough users of Apple DOS 
(Dumb Operations Systems) would let the pro- 
ducers know of their feelings, just as the CP/M 
users did, maybe it might do some good. 

I am sending this letter and a copy of this 
announcement to each of the Apple-related 
magazines in the hope that they will publish 
them in the letters to the editors column for 
the enlightenment of the rest of the Apple 
users. 

Sincerely, 

W.R. Eade 

San Marcos, CA 



marketalk 



Editor's sui«ry uf article by 
Paul Freiberger that appeared in the 
Oct. 19, 1991 issue of Infotlorld; 

SUfERCALC HftKER REKOVES 
mi PROTECTION 

"Consuters have successfully pres- 
sured Sorci» to renove the copy-pro- 
tection features fro« its recently 
released SuperCalc prograi. "Sorcia 
had sought to protect its nett Visi- 
Calc-like product by using a lati- 
tude of copy-protection sthetes." 

In that article, 'Serai's presi- 
dent, fiicbard Frank, admitted that 
the fin had received pressure to 
reiove the copy-protection tricks," 

He is quoted as saying "Custoiers 
coiplained, so ite retoved it." 

Paul noted that 'The pressure frot 
buyers is sisilar to that experienced 
by HicroPro International last year 
when it attempted to protect its o»n 
CP/H- based prograi, WordStar, froi 
copiers." He added that "MicroPro's 
decision to recall a tenth's supply 
of software cost the fin *H,W«." 



Dear Editor. 

This past year has seen much in the small 
computer literature about software piracy. A 
great deal has been written about the dis- 
honesty of the software consumer who cop- 
ies rather than buys. I wish to turn attention to 
the dishonesty of the seller who overprices 
software. 

in a free market, the seller has a perfect 
right to charge "what the market will bear" 
for his product and protect that product from 
copyright or patent infringement, I believe 
that the market is basically honest. I submit 
that the extent of piracy by potential buyers 
of software directly reflects the degree to 
which sellers overprice their product. To 
amplify, consider what is known about the 
market and how this is perceived by buyers 
and sellers. 

To the buyer, the price paid for software is 
seen as the cost of the right to use the soft- 
ware plus the cost to produce a copy of it. 

Consider first only the production costs of 
some typical package composed of a single 
disk and perhaps 50 pages of documenta- 
tion. Given current costs for raw materials in 
quantities of a few hundred, It Is profitable to 
sell such software for as little as $5 per pack- 
age. 

The buyer considers his cost to copy such a 
package at about S10 depending on his 
cost for blank disks, copy programs, and 
photo-copying service etc. If the package 
retails for $20 then the buyer sees the cost as 
reasonable and buys; if it sells for $200 then 
he sees the cost for the fight to use the pro- 
gram as an exorbitant 20 times the cost to 
copy it. 

At20-to-1 he copies. 

If apples cost S 100 a bag, you could bet I'd 
turn farmer or thief. But buyers and sellers of 
apples operate in a free market and apples 
cost closer to a dollar a bag even with the 
considerable expertise required to breed 
apples and operate an orchard, 

Meanwhile the average list price of soft- 
ware in Softalk's Top Thirty is S140, a whop- 
ping 14 times the cost to copy any single one 
of them. This should promote some fairly stiff 
competition. Instead, new entries are intro- 
duced at still higher prices and the pup 
Ushers scream bloody murder that people 
copy their software. 

Assume that a publisher believes his effort 
doubles the value of his product and he sells 
it for ten dollars. If a publisher charges more 
than ten dollars for a duplicate of his disk 
then he is ripping you off. If he charges more 
than ten dollars for a new version he Is either 
ripping you off or Implying a claim by the 
author that the new version represents an 
extraordinary effort. If an updated version 
costs $50 to each of say 500 users then the 

continued on page 25 



P.O. BOX 44549 TACOMA, WA 98444 



PAGES 







After printing only three issues and two updates (all of them late . . . ], and 
after examining them for content (good ol' hindsight!), we find that there are 
a great many more neglected areas of Apple computering which we need 
to cover. 

One correspondent asked me, ''Where can you go after you've com- 
pleted your review of bit-copy programs? Will your magazine lose interest?" 

Well, since you asked, I will confide to you my very own candied-Apple 
visions. . . 

Computer software is a very unique product with its own special character- 
istics that easiiy differentiate it from other forms of software such as film, music, 
etc. But treating computer software as if it is like music or film recordings also 
denies its most important characteristic . . . computer software is an active 
and interactive product, not passive like a recording of some image or 
sound, it is sad that it is still lumped in the category of passive software. By 
thinking of it in terms of un-alterabillty, computer software becomes just 
another form of static literature. 

Interactive as a machine, computer software has the ability to be altered; 
made better, easily, by changing a few codes here and there, This means 
that, unlike passive software, computer programs can become instantly 
obsolete, and instantly updated, if is this phenomenon of obsolescence vs 
updating that differentiates computer software from passive software, 
Updating is the most critical feature of programs, a feature that we would all 
love except for one thing. . . copy-protection. 

This most wonderful of all aspects of interactive software has turned into 
one of the biggest nightmares of ail. Normally, updating would simply consist 
of entering the new and altered code, but because software is often 
"locked" and unlistable, the only easy way to improve obsolete software is to 
send for the new program. This process is annoying to users, but quite profit- 
able to most of the publishers, 

There should be a place to turn when you want to update programs your- 
self, a place to exchange updating ideas even on copy-protected soft- 
ware. What software have you ottered, improved, fixed? Tell us about how 
and what you did. 

Another topic HARDCORE should cover is "how creatively is commercial 
software being used?" After all, there's a lot of good Apple software out 
there. Is it being used, and how? I don't mean a review of the software. 
Reviews can be found in all the other magazines. What I do mean is: "User's 
Only" columns showing how peopleare using certain types of software either 
for their original purpose or for more creative purposes, For example, Visi- 
Calc has its own users' column in some magazines. Certainly there are other 
well-used programs that deserve a column of their own. 



I can think of three right off: the three leading bit-copy programs. How 
about others? DOS Toolkit is covered in NIBBLE. What about other graphic 
packages? And other business and utility software? You tell us what columns 
you want. Better still, write an article explaining how you use some specific 
software; a step-by-step specific problem-solving technique. If you've used a 
graphic package to write software, share that program with our readers. 

It's up to you, the users, 

We're a small magazine aimed at the serious users of Apple software. And 
we're trying to keep alive the Idea that it is the users and not the producers, 
who should determine the value of computer information and its usefulness. 
We've tried to provide open education and entertainment without predeter- 
mining if that information should be kept secret. Let's start making HARDCORE 
an effective user forum. Keep those letters and articles coming in. 



Charles R. Haight 
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SENSIBLE SOFTWARE, INC 

The Utility People 

Making Life with the Apple II A Bit Easier 



DISK RECOVERY 
THE SCANNER" 

48K + , Disk II 

Apple ii/Appte 11 + 

$30.00 

Are you plagued with disk I/O errors? 

Does the integrity and safety of your 
data concern you? 
This program is a must for ail 
Disk li owners!! 



Just as "Apple Pascal" provides a "BAD BLOCK SCAN", DISK RECOVERY will do a 
complete scan of your diskettes' recording surfaces. Damaged areas will be 
"marked" as used in the disk directory so that no attempts will be made to 
"WRITE" to a bad sector. The VTOC is completely rebuilt to accurately reflect 
BAD, USED, and FREE SECTORS, further insuring the integrity of the diskette. A 
complete report is generated advising the user of all corrections BEFORE the ob- 
ject disk is altered. A resulting "DISK MAP" is presented for vour review. Flexibili- 
ty of the program allows evaluation of NEWLY INITIALIZED DISKETTES as well as 
DISKETTES THAT ALREADY CONTAIN PROGRAMS AND/OR DATA' The SPEED of 
analysis is unsurpassed- only 1B seconds for a 16 sector diskette! DISK RECOVERY 
is supplied in the revolutionary QUiCKLOADER format which ailows easy recon- 
figuring to make it fully compatible with 13 sector and 16 sector diskettes as 
well as your SUPER-TEXT data diskettes! TREAT YOURSELF TO PEACE OF MIND 
KNOWING THAT YOUR PROGRAMS AND DATA ARE SECURE WITH.. .DISK RECOVERY. 



BACK IT UP II has been improved and enhanced to provide the end user with the 
most powerful duplication system for the Apple II computer. Numerous 
PARAMETER CHANCES are allowed to directly handle the multitude of possible 
security formats as they are encountered. Direct study of these formats is possi- 
ble with our own NIBBLE READER. Both 'full tracks' and 'half tracks' may be 
analyzed individually. Preview the source disk with the QUICK SCAN option to 
readily locate pertinent data. When duplication is begun AUTOMATIC HALF- 
TRACKING is readily enabled. A powerful SYNCHRONIZATION MODE has been add- 
ed to the BACK IT UP II system The MEND TRACK function manipulates data 
from designated tracks that are otherwise irretrievable with other programs. 
The end user is kept WELL INFORMED of the progress and any problems en- 
countered once duplication h3s commenced. As with all SENSIBLE SOFTWARE 
products BACK IT UP II is extremely easy to use - USER FRIENDLINESS is more evi- 
dent than ever before. The documentation has been expanded to a tutorial 
ON DISKETTE FORMATTING as well as an easy to read USER GUIDE. 

The availability of this program in no way implies that SENSIBLE SOFTWARE, INC. 
supports software piracy and is intended for the sole use of the computerist 
who wishes to "back-up' his/her diskette library. Although itself uncopyable, SEN- 
SIBLE SOFTWARE, INC. does have a very liberal 55.00 disk update/replacement 
policy. 



BACK IT UP II+ 

48K + , Disk II 

Apple ii/ Apple n + 

$60.00 



WE LISTENED TO THE APPLE USERS! 
WE LISTENED TO THE REVIEWERS! 

NIW! IMPROVED! 

NOW EVEN BETTER THAN BEFORE! 




SENSIBLE SOFTWARE, INC. 

6619 Perham Drive Dept H 

West Bloomfield, Michigan 48033 

313-399-8877 

Visa and Mastercard welcome 

Please add $1 25 postage and handling per disk 
For a complete catalog, send $1 .00. refundable with your first purchase 
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Bev. R. Haight 



Unauthorized 

-8SK. GRAND PIRACY 



While software houses have been ranting and 
raving about the users who are making back-up 
copies of their products, a more dangerous and 
destructive form of piracy has become an 
accepted 'modus operandi' of some the software 
houses: blatant piracy of computer game ideas 
and their modes of expression, right down to the 
details of screen images! It is what 1 call: 
GRAND PIRACY (as in 'granO larceny') 
The game that first comes to mind [and there are 
quite a few of them being copied by competing 
houses) is Atari's Pac-man and the veritable hosts of 
pirated versions produced for the Apple market. 
(Time magazine, unfortunately confuses these two 
forms of piracy, See Otherwords.] 

While the copying of a disk directly deprives an 
author or company a few bucks (which may ada 
up to many bucks], a single person stands to gain 
only a few aollars, but receives a great deal of 
security, If the disk crashes, trie user still has a back- 
up [or, as I urged in my earlier editorials, a FEW 
back-ups). 

But when another software company pirates a 
game iOea and its visual expression, and then sells 
it for its own gain, it is collecting revenue that should 
have gone to the original author(s)and publisher. I 
believe that this is the WORST form of copyright 
infringement. 

As a published author of software, I fear this form 
of Piracy more than any other because, while user- 
duplication/ distribution 'for profit' of my games 
deny me only money, the theft of my game concept 
and mode of play Oenies me my claim to author- 
ship, which is more valuable than mere money 

And, to top it all off, it appeared that this form of 
Grand Piracy was fast becoming an accepted 
form of theft supported by the software houses! 

So it is with great relief that I read Atari's 
announcement that they would go after and pros- 
ecute authors and software houses that steal its 
game ideas and expressions, I congratulate Atari 
for taking a firm legal stand against this most 
destructive form of copyright infringement . And I 
support them in their struggle to chastize On-Line 
Systems for its obvious acts of GranO Piracy. 

For a while it seemed as if Apple-users ana pro- 
grammers were excellent craftspeople but quite 
unimaginative artisans. They seemed to be copy- 
ing game ideas rather than coming out with new 
and better ones. I hope that, as more people real- 
ize how easy it is to write programs, more of them 
will enter the commercial field and add to the 
growing number ofApple-basea programs availa- 
ble to the users. 

Software houses should adopt Atari's stand 
against Grand Piracy rather than continue their 
self-debasing accusations of petty piracy against 
the everyday users. Apple-ites are quite tired of 
copy-protected disks and will soon stand up, as 
CPM users do, ana either stop buying protected 



programs or urge the soft-houses to stop protecting 
their disks. [*CPM programs are not protected. See 
Reader Input) 

ATARI vs ONLINE SYSTEMS 

I have been notified that Atari won its suit against 
On-Line Systems. It is a victory for creative authors 
everywhere. My next question is whether Atari will 
now selfishly deny Apple-users of the Apple ver- 
sions of Pac-man in oraer to promote sales of only 
its Atari game system. If so, then Atari is taking a 
very short-sighted view and should also be chas- 
tizea. The authors of the copied games maOe an 
honest effort [and often a very exceptionally- 
crafted copy) of a popular game and they should 
be both compensated and credited [much like 
translators of books not originally written in English) 
ana the game shouia be allowed to be licensed 
for distribution by On-Line ana the other houses. If 
not, then I foresee that these games will be hot 
items on the 'black market.' 

Since I've had my say on the topic of Grand 
Piracy, I openly solicit other views on this topic, 
especially from the software houses and authors 
involved. 



PAGE 8 



RO. BOX 44549 TACOMA, WA 98444 






There are many people who are genuinely con- 
cerned about "Piracy" and "copy-protection," 
people who are proposing solutions to this com- 
plex dilemma. 

Bill Parkhurst, President of the Santa Rosa Com- 
puter Center, Inc., in California, took the initiative 
and wrote to us concerning one such solution. He 
also wrote to 3M about his proposal. In response to 
our inquiry, Bill Parkhurst explained some of the 
details of that solution. I encourage you to submit 
your own opinions and proposals for publication 
so that we can go on and make the software busi- 
ness both equitable and profitable for all con- 
cerned. Ultimately, the solution will be a unique 
one based on the fundamental differences 
between an "active" computer program and all 
the other forms of published and transmitted "pas- 
sive" programs like literature, music, etc. But we 



must begin by seeking out the solutions used by 
those involved in the "passive" program industry. 
-BRH. 

Dear Editor: 

Basically, my solution is parallel to what is being 
done in the recording arts. 

You see, all royalties in the music industry are 
monitored and distributed by two publishing 
houses; BMI and ASCAP If anyone writes a song 
which is going to be placed on magnetic media 
through a record company, then that author is 
automatically signed upas a member of either BMI 
or ASCAP, Part of their job [BMI and ASCAP] is to 
monitor air-play [the number of times a record is 
played on the radio by the various radio stations) 
and from that come up with the relative percent- 
age per song in terms of the number of times it is 
played within a given period. 

For instance, if Chubby Checker had a song that 
he wrote on the charts, say the Number One 
record, then Chubby Checker would receive the 
biggest chunk of the royalty pie. 

Now to put that in perspective, if VisiCalc is the 
top selling program, then obviously VisiCalc 
deserves the top percentage of royalties for that 
given period that Is being measured. 

My solution would be to base the royalty on the 
total number of BLANK DISKETTES sold during the 
period. 

I did receive a letter from 3M saying that they 
would be glad to supply the figures to the publish- 
ing house which Is doing the monitoring for our 
industry. This publishing house would, of course, 
have to be established and incorporate in its mem- 
bership a majority of the software producers In 
order to be effective. 

Ultimately, it would BE effective because the reve- 
nues to the authors would be substantially greater 
than what they are getting now just from program 
sales. Also, as an additional benefit to the pro- 
grammmers, they would no longer have to spend 
extra time with encryption techniques. This would 
ultimately benefit the consumer in the form of lower 
prices for software. 

Copying a program is a sincere form of flattery 
The average "pirate" is an educated, middle-class 
citizen with no criminal record, As a practical mat- 
ter, as the music industry discovered. It doesn't pay 
to chase millions of consumers who are busy con- 
suming. Record companies know people are 
recording songs off the air. So they base royalties 
on air-play. I have never heard a musician com- 
plain about people recording their songs from the 
radio. 

So let them all copy to their heart's content and let 
the programmers get paid for it! 
Sincerely, 

Bill Parkhurst 

PS, At Santa Rosa Computer Center, Inc., we do 
NOT encourage copying of programs, In fact, we 
spend a lot of time keeping people from doing It, 
which drives up the cost of doing business. 
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Computer code must be kept hidden and secret ! 



Dear Editor Haight: 

As a subscriber to Hardcore, I want to 
express my strong disagreement with 
some of the notions that you recorded 
in your editorial in the first issue of your 
magazine, 

Yes, obviously, everyone has the right 
(and should be given the ability as well] 
to make back-up copies of disks. Your 
contention that everyone should be 
able to inspect the code, however, is 
counterproductive. 

I think that the goal of any user is to 
see that high quality software is pro- 
duced and available, How can we be 
sure that good materials are pro- 
duced? By making sure that the crea- 
tion of first-rate programs can be a 
money-making venture for people who 
have taken the time and effort to 



become good at writing software. If 
each program can be inspected, then 
those good ideas that people come up 
with can be used (pirated) by anyone 
else. Now spreading good ideas 
around may be good, but if someone's 
good creative ideas can be copied (by 
someone else who doesn't want to do 
the work of figuring them out) then the 
people with the good ideas will stop 
publishing. If they stop publishing crea- 
tive materials, we all suffer. You have 
compared being able to see program 
code with being able to see the inside 
of an automobile engine. A better com- 
parison would be with being able to 
seethe recipes of a prize chef. The chef 
understandably wants to keep secret 
the recipes that took so much effort to 
create, 



You also say that much software is 
over priced. The price of software, like 
the price of many other things, is deter- 
mined in large part by a balance of 
supply and demand. If the price is high 
enough (too high?) then the best peo- 
ple will be attracted into the business of 
producing software. If the price is too 
low, the Pest people will make their 
money doing something else, Before 
you write your next editorial, I suggest 
that you give more thought to how we 
can ensure a continuing supply of crea- 
tive software (new ideas) if peoples' 
ideas are taken as soon as their pro- 
grams are published, 

Very Truly Yours 
Richard Cornelius 
Assistant Professor 
Wichita State U.,KA 



Where do first amendment rights of pirates stop? 



Dear Editor; 

I feel fairly confident that I know your 
stand on the issue of 'software protec- 
tion' and 'software piracy' After all, it is 
rather obvious from reading your first 
two issues. Let me tell you a little about 
myself. 

My name is Allen L, Wyatt. I am a soft- 
ware author, editor, consultant, and 
one-time publisher, I feel that I have a 
right to make comments on this issue, 
for I have just as much at stake, if not 
more, than most of your readers. 

Before you cry 'foul' or judge me as a 
member of the 'software bureaucracy 
holding poor customers captive,' let me 
state that I am not here trying to point 
fingers, I am not writing to try to 'call 
down' your magazine. In fact, I wish to 
applaud your first several issues. In 
between the f lag-waving and wording 
designed to make people act on emo- 
tion alone, there were several very well- 
done and informative pieces that were 
well-worth reading. 

I am writing, though, to raise a few 
questions. You see, many times in the 
real world, issues are not nessarily black 
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and white, It is not a matter of the 'good 
guys' against the 'bad guys.' In fact, 
both sides of this issue have several 
good points. Conversely, both sides 
seem to be at fault in several areas. 

Software publishers make quite an 
investment to bring a product to mar- 
ket. A good deal of money goes into 
development, royalties, marketing, 
packaging, support, raw materials 
and, yes, even 'protection.' The last 
area is there to try to 'protect' the other 
areas. Many times, the life of software is 
measured in weeks, or months at best, 
and a good deal of money is at stake 
for all concerned with a product. 
Besides this, publishers serve as a vehi- 
cle for spreading ideas. They serve to 
transform local markets into national or 
international markets, 

On the other hand, users have a 
'right' to software that works (bug-free), 
that is modifiable (if necessary), and a 
back-up to protect their investment in 
the software. It is frustrating at Pest to 
have a piece of software crash and not 
have a back-up. 

Besides these valid points there are a 



few other points that must be consid- 
ered. It would be extremely convenient 
and idealistic to say 'all software should 
be unprotected.' That would definitely 
solve the problem for users, but not 
necessarily for publishers and authors. 

There are computer users who are 
genuine 'pirates,' even though I am 
sure the number is small . No matter how 
small the number, they can hurt and, in 
the case of small publishing houses, 
severely damage a business, As an 
example, look at Pirates Cove. They 
are, by their own admission, pirates 
and they claim protection by first 
amendment rights. 

I, in fact, would like to see publishers 
not have to copy-protect software pro- 
ducts. It would certainly be less expen- 
sive for everyone concerned. 

Where do the first amendment rights 
stop, however? According to the courts, 
they stop when they interfere with the 
first amendment rights of another. When 
does that happen? Does it happen 

continued on page 44 
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Software Insurance Policies 

"a Whole Hew Ancillary Business." Tod Hoicks 



Dear Editor, 

Much has been written in recent months in com- 
puter hobbyist magazines (both general and 
Apple-specific, as well as Apple club newsletters) 
about the pros and cons, mostly the latter, of bit 
copiers and, noncommitantly, software piracy. 
Some of these comments have taken the form of 
emotion-charged editorials or comments without 
byline presenting the prevailing view of the maga- 
zine management who are sometimes funded by a 
software house [ie. Kilobaud Instant Software], 
Other written pieces have been reader responses 
to the above. Now it's my turn. 

I have owned an Apple II for over two years and 
use it tor fun and games, hobby, and I use it with my 
home-business, I have invested some pretty good 
money in professionally-prepared programs, 
including Visicalc, DB Master, and a Pascal Text For- 
matter. These three, along with Synergistic Soft- 
ware's Mail Label Program (used to generate 250© 
labels per month] are the most often used of my 
heavy artillery, 

To not have backups would be foolish, I have an 
authorized backup for DB Master, sent when I 
returned the registration card. The text formatter 
came with two disks, and the Synergistic program 
wascopyable. 

I welcomed the first bit copier and immediately 
copied Visicalc (rather than send Personal Soft- 
ware S3© for a backup), I have heard of problems 
regarding dust and heat vis-a-vis the not-so-hardy 
disketts, so I self-insured my business by having 
THREE backups for my expensive software. 

The original is kept in a protected chest, two cop- 
ies are handy on my computer table, while the third 
copy is kept in a safe-deposit box. Overkill? Per- 
haps, but I'm assured that I won't have wasted my 
hard-earned cash if something happens to one of 
my program disks. And for most of us, the operating 
phrase is 'hard earned cash,' because money 
doesn't grow on trees and when a good program is 
produced, it is important to insure it. 

This insurance of software could open a whole 
new ancillary business. I recently bought two new 
packages which totalled over $40©, After leaving 
the computer store, I ran some other errands at 
another location. When I returned to my car, I 
noticed the software was missing. Someone had 
jimmied the lock of my hatchback and ripped me 
off before I could even make copies!! 

I notified the police and drove to my insurance 
agent. The forms were processed and I went home 
to figuratively wait for my claim [less the SIS© 
deductible] to arrive. 

Several weeks went by and I was just told by my 
agent that this claim was not going to be honored 
by the home office due to an exclusion against 
magnetic information stored on disks, etc, except 
for the value of the blank medium. Ha, Ha. 

1 checked with a couple of other agents, who 
had to find out from their respective parent com- 
panies. To a man, they told me that software pro- 
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grams weren't insurable; I couldn't even get a rider 
to the policy to take care of the exclusion, 1 also 
found only sympathy from the distributor as they 
couldn't help me since I hadn't mailed them my 
registration card. 

Now I'm out the $40©. 

Here's a neat solution which hopefully would 
satisfy dealers, customers, users, authors, distribu- 
tors, in fact, everyone, This should take care of soft- 
ware problems ranging from loss due to theft or fire. 
to carelessness with the program disk (overwritten 
programs). 

When the customer buys the software, he or she 
has an option to buy into an insurance program, 
either by the piece or a blanket coverage of soft- 
ware. If this is the customer's choice, then his name, 
the program name and serial number, date sold, 
and any other necessary information, are entered 
in a data bank. 

If the user develops a problem, he or she returns 
to any computer store hooked into the data bank 
with his customer ID* and explains the problem. If 
the program is important to his/her needs, a 
'leaner' could be let out, with a reasonable deposit 
kept at the store. The information relating to the 
damage or loss would then be entered in the data 
bank and a replacement copy mailed to the cus- 
tomer. Some safeguards would necessarily be built 
into this system to protect everyone involved from 
flagrant misuse, This could include a magnetically 
encoded ID* on a membership card, which could 
be read by a reader and verified by the data 
bank. 

Another security device is simply the rapport built 
up between shopkeeper and customer, Most of us 
settle on one computer store as our primary vendor 
after a while, and we usually are welcome to 
browse and get a sort of 'favored customer' treat- 
ment, ranging from hot programming tips to a free 
cup of coffee to a willingness to take the time to 
answer questions. They know with whom they are 
dealing and could assist in the speedy recovery of 
lost or damaged programs. I know; I've already 
been helped immensely by the people at my com- 
puter store. 

Thus the software authors and vendors, the edi- 
tors who shout, 'Stop thief!' and all others involved 
with the production of software should start with 
positive foreword thinking and not stamp their col- 
lective feet and throw tantrums about what's 
already happened. These people are clever 
enough to bring out some damned good pro- 
grams; they can put their creative thinking to work 
in helping the customers and themselves by learn- 
ing from the past and applying those lessons to the 
future, I want action and insurance, not rhetoric 
and recriminations, 

Sincerely, 

Tod A. Wicks 
Palo Alto, CA. 
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"It is true. 
We are against software protection. 

We don't think in the long term it is 
the best thing for the industry or the 
customer " 



HARDCORE: What is your definition of the sit- 
uation you call 'software protection? 

MARKKULA: 'Software protection' is the uni- 
verse of schemes used to prevent unauthor- 
i2ed copies of a program from being made 

HARDCORE: And that would include hard- 
ware and software protection. . . . 

MARKKULA: ...Software, hardware, fooling 
around with operating systems, licensing 
agreements, and so forth . . . Whatever is 
used to prevent unauthorized copying . . . 
The keyword being: unauthorized. 

HARDCORE: Do you agree with the defini- 
tion of 'unauthor izea' that includes back-up 
copies? 

MARKKULA: No I don't. Some protection 
schemes are not perfect, and in their effort to 
prevent unauthorized copies they prevent 
authorized copies as well. 

HARDCORE: At the conference* did you 
get the response you expected when you 
made your statements regaraing copy- 
protection? 

MARKKULA: Yes. 

HARDCORE: Creative Computing" saia 
that 'The software pirates in the audience 
applauded.' Do you feel that is an accurate 
assessment of the audience's response to 
your statements? 

MARKKULA: No. There were many legiti- 
mate software authors who participated in 
that applause and came up and saia so 
after the meeting. They heara the whole 
statement. A lot of it was left out when the 
quotes came out in the papers. And the idea 
of forming an industry association that would 
tackle this problem and do what was good 
for the customers, the authors and the pub- 
lishers simultaneously is what the authors 
were after. 

HARDCORE: Was that the first time you 
made such an announcement regarding 
software protection? 

MARKKULA: Yes. 



HARDCORE: Have you made any similar 
announcements after that? 

MARKKULA: Yes I say the same thing every 
chance I get. 

HARDCORE: What has been the response 

to those statements since then? 

MARKKULA: I've gotten a lot of letters, and 
they've been running about half-and-half in 
favor of or against. There are many sugges- 
tions that are constructive suggestions: ideas 
on how we might go about solving this prob- 
lem as an industry, and we're collecting those 
and writing a 'White Paper.' if you will, to try to 
get the industry off of dead-center and begin 
to make some progress toward solving the 
problem. 

HARDCORE: Did you receive any innu- 
endos from software people saying that 
they'll cease software development for the 
Apple and go on to other computers if they 
aren't able to copy-protect their material? 

MARKKULA: Yes, ana those generally came 
from having read in the news media what 
was quoted which didn't include the rest of 
the discussion there. 

HARDCORE: In other words, the quotes 
were generally out-of -context . , . 

MARKKULA: Yes, because I said that we 
wouia SUPPORT software protection until such 
time that we could offer an alternative solu- 
tion which would be considered appropriate 
and reasonable by the various elements 
involved in this business. One of the com- 
mentslmaaewasthaf 'it was like Usterine . . , 
we don't like it but we use it.' And that's really 
our only choice at this point. There is no alter- 
native which would allow the authors of the 
community to continue to have a profitable 
business for themselves if we don't support 
protection in some way 

HARDCORE: What do you think of the 
authors and the software companies who 
are now changing their protection policies 
and not protecting their material and, in fact, 
encouraging that back-up copies be made. 

MARKKULA: I think that they're going to win. 
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* At the Boston Computer Society's forum on 'The Future of Personal computers'' held at the 
Northeast Computer show (Boston, October '8D, Mike Markkula, president of Apple Computers, 
Inc. surprised many of the audience by taking a stand on the "Copy-protection" controversy in 
favor of its elimination. 

"in perhaps the most surprising and controversial statement of the evening;' reported 
Creative Computing, "Markkula urged the elimination of software protection. The software 
pirates in the audience applauded.'' CC went on to add that "he promised that Apple 'will work as 
diligently as we can to eliminate the situation that we call software protection: " Byte also 
reported a similar quote. 

Bev. Haight interviewed Mike Markkula by phone in May to find out how the world of personal 
computers reacted to such a stand. The following article is an edited transcript of that 
conversation. 



I think the whole thing is a matter of eco- 
nomics. The end result (of copy-protection 
measures) now is that developing legal 
mechanisms to really take those people to 
task who make unauthorized copies (has 
evolved) to the extent that it is deleterious to 
the authoring and distribution community. If 
we can increase the volume of programs 
that are sold sufficiently that the 'economies 
of scale' reduce the manufacturing costs 
and the distribution costs to the point where 
the legitimate customer would prefer to Puy 
the original item which has a warranty, a real 
'honest to goodness' manual with it... I think 
that he will consider it in his best interest to do 
just that. And, I think, he will feel that he is get- 
ting a fair value for what he spends. 

HARDCORE: That depends a great deal on 
increasing the 1 number of Apple sales, too, 
doesn't it? 

MARKKULA: Well, it's not just Apples, It's ALL 
personal computers. Of course, we would 
love it to be all apples, but that's sort of the 
short-sighted view. 

HARDCORE: You mentioned the 'White 
Paper' you are working on. What steps have 
you taken in the direction of uncovering a 
solution other than software protection. 

MARKKULA: Well, the first thing we did was a 
very extensive technical analysis in conjunc- 
tion with some people at Stanford and the 
conclusion of that study is that, unfortunately, 
we can find no technical solution that works, 
that can't be broken. There is theoretical 
proof of that. And I think that we should make 
that fact known, 1 think people should under- 
stand that. 

HARDCORE: In other words, copy- 
protection simply won't work if the Informa- 
tion about how it's protected gets out. 

MARKKULA; Even if it doesn't, someone will 
find a way to make copies. The question is, 
'how long does It take, and how much effort 
do they have to put in to do it.' It's not a ques- 
tion of: 'is it unbreakable,' because techni- 
cally. It can be proved that there is no 
scheme which cannot be broken. 

The next thing we did was to put some peo- 
ple to work making a study of other publish- 
ing types of industries such as records and 



tapes, books, and so forth, to find out 
whether or not they have had similar prob- 
lems and what they have done about it. And 

it turns out that they DO have the same prob- 
lems, and there ARE revenues lost due to 
unauthorized copying. And in some cases, 
the revenues are significant. 

HARDCORE: As in the video industry? 

MARKKULA: Video, records . . So we tried 
to collect the data, the numbers, so that we 
can say 'Now look. Here's how big the prob- 
lem is.' Nobody has any data to tell you what 
percentage of the software gets copied or in 
the long run, what percentage of revenue 
are we going to lose because of this. 

So we tried to get some data together and 
draw some conclusions based on other 
industries as to how big the problem might 
be in our industry That, we hope, will lead to 
some reasonable and thought-out solutions 
which are based on reality rather than a lot of 
emotionalism. 

And the thing we are doing in that Paper is 
to propose some mechanism that might be 
used on an industry-wide basis, not just an 
Apple effort, to pursue some of these solu- 
tions and decide on one and go ahead and 
implement it. And those possible solutions 
have a fairly wide range. 

HARDCORE: Have you proposed this to 
either those who support, or oppose you? 

MARKKULA: Not yet. We want to make sure 
that we get all of this stuff done. And then 
we're going to send a copy to each of the 
peoplewho have written in. Also, we hope to 
get the paper published someplace so that it 
can gain wider distribution. 



HARDCORE: 
pleted? 



Has that Paper been com- 



MARKKULA: No. We're still working on it. 
Somebody has to do some work, you know. 
You can't just sit back in your office and con- 
jure up these things. You've got to put some 
effort into it. There are four people working on 
it now, not all full time. But four different indi- 
viduals are contributing. 

HARDCORE: Have there been any software 
companies or magazines that say that they 
support you. 



MARKKULA: No. Most people are still in the 
questioning phase. And part of the reality of 
the problem is that no one knows how much 
of a problem if really is. No one can make a 
value judgement today, or a business judg- 
ment, that's based on anything other than 
rumor, hearsay and supposition. So, if you 
were running a software company and you 
were faced with the decision: 'should I pro- 
tect my software or not?' You don't have any 
way to know what the ramifications of that 
decision would be. You don't know how 
much you are going to lose. You don't know 
how much the market would increase if you 
could offer the product at a lower cost 
(because you didn't have to spend money 
developing a protection scheme} 

There isn't any data for people to make 
that decision on. So those that make the 
Oecision would say that the safest thing to do 
is to protect it 

One of the things that Apple is going to do 
in order to help generate some of that data is 
offer a major program in an unprotected 
form 

HARDCORE- What program is that? 

MARKKULA: I can't reveal that yet. But we 
will be announcing a new program which is 
a very significant one. and we're not going to 
protect it! 

HARDCORE: Is this just an experiment, a 

short-lived venture that can be quickly 
changed? 

MARKKULA: It can certainly be changed. 
But, we really are going to carefully measure 
the sales of that product and try to assess 
how many unauthorized copies are made in 
order to generate data for the industry to use 
in helping to make decisions on whether or 
not we should have some form of software 
protection 

HARDCORE: 1 thought that someone had 
earlier attempted something like that . . , 
where they took a program and released it 
unprotected in a specific area in order to see 
how fast pirated copies would reach the 
opposite coast . . . 

continued on page 67 
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The purpose of this column is to give 
some hints to you, the Apple II user, as to 
how you might be able to break even in 
a jungle of software and hardware pur- 
chases, 

I'll try to give you my ideas as to the 
best way of dealing with manufacturers 
or sellers of unknown quality (unless you 
have to, DON'T), and some general 
hints as to what to look for and what to 
look out for. I'll start this thing out on the 
assumption that consumer dissatisfac- 
tion does exist, and that at least some of 
the time such satisfaction is justified. 

Let me know if you see things going 
on (or happening to you) which you feel 
are wrong. I'm probably not going to 
solve your problem, but I might be able 
to help others avoid the same mistakes, 
(Of course the threat of publicity might 
also have a salutory effect on a poten- 
tial settlement, but then again, I suspect 
there are manufacturers out there who 
could care less,] 

If I don't receive correspondance 
relating current problems, I will assume 
that everyone is happy, that nobody 
feels wronged, and that this column is 
completely unnecessary. 



mvmcAio 



Let's start with some personal com- 
ments on good guys and bad guys I 
have dealt with. (And sometimes they 
are the same outfits). 

High on my list of split personalities is 
Personal Software, Inc., the publisher of 
VisiCalc. 

VisiCalc is a marvelous program. 

(Hooray!) 

Why did they charge me the outra- 
geous price of S65 to update from 3.2 to 
3.3, when the reason that I couldn't 
'Muffin' the program, myself, is that it is 
'locked', 

(Boo!) 

But the 193 version has significant 
enhancements, such as Boolean 
operators, and DiF. 

(Hooray!) 

But the 193 was officially declared 
defective as of August 1981, only a 
couple of months after I got my 
upgrade. 

(Boo!) 

But PSI sent me the Version 202. free, 
to replace the defective 193. 

(Hooray!] 

But they charge someone who 
bought the 193 for S200, originally, 
another S 15 to upgrade to 202. 

(Boo!) 

The company claims that the 
'upgrade' charge only covers their 
costs, and is not an attempt to wring 
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FROM A BUYER'S POINT-OF-VIEW 

GOOD GUYS, DAD GUYS, AND 



another dollar out of the consumer. 

(Hooray!) 

But PSI strongly objects to the thought 
that a registered 202 owner might help 
both the company and another regis- 
tered 1 93 owner (who might have inad- 
vertantly purchased the program well 
after the recoil date— PSI did not draw a 
lot of attention to the recall) by simply 
making a LOCKSMITHed copy of 202 
and giving it to the 1 93 owner, thus sav- 
ing PSI a lot of time and trouble. (A viola- 
tion of copyright, they say, and 
probably correctly so. But why would 
they object if they weren't making 
money on the S15?] 

(Double Boo for the Double Talk!] 
if I had the 193 version, and particu- 
larly if I had purchased it after August 
25, 1 would scream bloody murder until 
my dealer, the manufacturer, or some- 
body, replaced the defective program 
free of charge. I wouldn't sue by myself, 
however. The 3 1 5 replacement charge 
clearly isn't worth it. 

(As I reread the foregoing para- 
graphs, I guess I sound a bit ungrateful, 
as PS! did send me my update free. Yes, 
Personal Software, I am grateful you 
sent me mine. But why not do the right 
thing all the way around?) 

A1X-80 VMIX-UP 

With that tirade out of the way, let me 
go on ... and present a boquet to 
JADE Computer Products, who started 
out with a normal misunderstanding 
that was at least a bit my fault, and 
ended up giving me full satisfaction, 
with only 2 '800 number' phone calls. 



Last summer I decided it was time to 
buy a moderate priced dot-matrix 
printer with friction-feed and hi-res 
graphics, and that the Epson MX-80 F/T 
seemed the way to go. 

(Bayer consumer protection rule #1: 
'Never buy ANY computer product 
unless you've seen it advertised at least 
SIX months in a row.' This probably 
insures that anything I buy will be obso- 
lete before I get it, but it Cuts down on 
the possibility that I will pay a premium 
price to become a Beta test site.) 

The JADE price, which included 
graphics, was just right, and I ordered 
one by telephone, charging a credit 
card. I was dumb enough not to get an 
order number, nor the salesman's name 
(but thanks to JADE's attitude, this wasn't 
fatal to my cause.) 

Many weeks passed, with JADE 
responding to my calls with the mes- 
sage that they were simply not getting 
what had been promised to them, 1 
decided to hang on, however, and one 
bright October day UPS delivered the 
package. A quick look at the docu- 
mentation made me suspect that the hi- 
res graphics PROMs were not part of the 
package, and this suspicion was con- 
firmed by telephone, 

Although I had NO written documen- 
tation of my order which indicated that I 
had intended to purchase the graphics 
as part of the agreed price, Scott 
Anderson of JADE agreed that the 
advertising on which 1 had relied did 
indicate that the PROMs were part of 
the deal. (I get the impression that either 
the importer or JADE's distributor may 
have misadvised JADE when the origi- 
nal advertising was placed.) He 
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agreed to either (a] send me the 
PROMs, (b) take the printer back on 
other merchandise, or (c) take the 
printer back and cancel my charge. 
Here I was quite ready to be righteously 
indignant, but Anderson and JADE 
wouldn't even let me rant and rave. I 
was impressed! I'll certainly consider 
them on my next purchase. 

(I finally installed the PROMs a couple 
of days ago, and was ready to 
demand JADE replace them under 
warranty, because they were defective. 
I saved myself a considerable amount 
of embarassment by checking the 
entire installation procedure outlined in 
the manual, and changing the switch 
position I had previously neglected to 
do. 

Bayer Consumer Protection Rule #2: 
'Always read and follow the documen- 
tation before you start serious com- 
plaining.') 

NONW4RRANTIES 

As long as we're talking about the 
Epson Graftrax 80 PROMs, let's finish up 
this month with something that you will 
read about again and again in this 
column: LAWYER OVERKILL IN WARRANTY 
DISCLAIMERS. Let me start out by saying 
that the PROMs work very well; I have 
had no problems with them. But the 
'boilerplate' in the manual is unbelieva- 
ble. 

First of all, although I thought I PUR- 
CHASED the Graftrax 80 package as 
part of the printer, Epson America, Inc., 
claims they are only LICENSING me to 
use the program, 'in connection with a 
standard, unaltered MX-80 or MX-80 F/T 



computer printer manufacturer by 
Epson.' 

(Does this mean that, if I repaint the 
■case a different color, I can't use the 
graphics?) 

This 'license agreement' gets better. 
'Customer understands and agrees 
that he/she will not copy, reprint, dupli- 
cate or modify all or any part of Graf- 
trax 80 . . .' and that Customer will not try 
to 'reverse engineer' the program, that 
is, to disassemble to object code to see 
what makes it tick, 

On the inside of the manual, we have 
the statement that Epson disclaims all 
implied warranties including, oddly 
enough, warranty for fitness for any par- 
ticular purpose (presumably, even the 
only particular purpose for which the 
Customer can use it, if the 'license 
agreement' is to be believed), and that 
THE BUYER (AND NOT EPSON AMERICA 
INC, ITS DISTRIBUTOR, OR ITS RETAILER) 
ASSUMES THE ENTIRE COST OF ALL NEC- 
ESSARY SERVICING, REPAIR OR CORREC- 
TION. . , 

Clever. The Buyer (notice 'buyer' and 
not 'licensee' . . . hmmmm) has to pay 
for patching the program if it doesn't 
work, but he is prohibited by the 
license agreement from modifying or 
disassembling the program. 

I suppose the answer is that Graftrax 
80 seems to work without any problems 
that I see, so who cares what the docu- 
mentation says, anyhow. 

But why is such overkill necessary? 

And what would EPSON have done if 
there really were problems in the 
ROMmed graphics program? 
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RESIDENT FIRMWARE UTILITY 
PROGRAMS WILL EXPAND THE 
CAPABILITIES AND INCREASE THE 
USEFULNESS OF YOUR APPLE II OR 
APPLE II PLUS! * 



APPLESOFT EDITROM 

Global search, change, or remove any 
string, variable, literal, constant, or baste 
command word that appears in your 
Applesofl Programs. EDITROM uses no 
ram space that will interfere with your 
program. It does not reset any system 
pointers lo protect itself and w]H operate 
with any size system - 1BK, 32K, or 48K. 
Alter EDITROM has been initialled, the 
ampersand (&.) command can then be 
used to call the EDITROM back for 
repeated use without readdressing the 
ROM + BOARD. Completely compatible 
with Konzen's Program Line Editor. It 
PLE is up. EDITROM will keep PLE up 
and allow joint operation. 
Will operate with any version of DOS and 
requires FP in Rom. 35.95 

COMMANDROM 

COMMANDROM Is like having a resident 
'FID 1 but with more operating features 
and conveniences. COMMANDROM will 
read a disks (13 or 16 Sector) File 
Directory Listing ar>d display the 
following: A Command Menu, current 
drive number, number of sectors used 
and left, number of pages sel up to hold 
all file names, the first page of file 
names, and an indenti Heat ion ictternext 
lo each Tile name on display. Pressrng 
any one of (he command keys will load 
or run any file (A 'B n hie toad will display 
start and length addresses.), lock or 
unlock a file orall files, delete a file - with 
verify before deletion, change from one 
drive lo the other, read a new disk, 
display a Track/Sector Map, change page 
numbers to view all file listings without 
recataioging, or exit to current language 
or monitor. No system pointers are reset 
and no RAM is reserved for 
COMMANDROM- Requires 46K, 3.2 or 
3.3 DOS and INT or FPin ROM 35.95 



BASICSROM 

Will boot a 13 sector disk on a system 
configured for 16 sector operation. The 
BASICSROM can be addressed on 
cordstart (without Auto Start ROM or 
warmstart (with Auto Start ROM) at any 
time 35-35 



DISK COPY/SPACE ROM 

Duplicates a disk, from either SINGLE or 
DUAL drive, single or dual controller, 13 
or 16 sector and with or wtthout VTOC. 
Opiions include - Gross copy, actrve 
sectors only copy. DOS overwrite, auto 
boot of copy disk, free space on disk in 
sectors and kilobytes, and Init and 
volume number are setectahle. Requires 
arninimumof 32K 35.95 

"APPLESOFT RENUMBER/ 
MERGEROM 

Made famous by Apple Computer Inc., 
this powerful utility will not disturb any 
part of a program in memory, when it is 
activated. Requires 46K, with or without 
DiskH. 35.95 



l YOUR'PLEROM 

Now you can put your Program Line 
Editor in ROM. Write Tor details. . S45.95 

' REGISTERED TRADEMARKS 

BOX 599 
WEST MILFORD. N.J. 07-160 

Soft CTRL Systems 

201-728-8750 
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The free enterprise system has encour- 
aged the birth and proliferation of some very 
greedy as well as some very consumer- 
conscious software outlets and producers. 
Most of us are aware of the greedy ones. 
They're usually the ones with the big bucks 
that permit clever and prolific advertising. It's 
the others that should receive the publicity 
and our business. One of those is known as 
the Apple Avocation Alliance, Inc. (which I 
call: the Triple A). 

AAA Is not only a Library of Public Domain 
Programs, but It is also a mail-order retail 
outlet for computerists, and a publisher of 
the 3A Press newsletter. 

Most computerists have a very meager 
software library that probably cost them an 
arm and a leg (which perpetuates those 
high -profit but low consumer-considerate 
businesses). The AAA operates on a low profit 
margin and therefore depends upon a 
larger quantity of sales, otherwise their 
growth will be slow and that will be a loss to 
all Apple off Icjanados, Here's why 

The AAA has over 121 volumes (diskettes) of 
Public Domain Software. Each disk has ten to 
40 programs, and each is categorized. The 
categories Include: Art and Graphics, Astron- 
omy, Aviation, Business and Finance, Chemis- 
try and Biology, Demos, Education and 
school. Electronics and Radio, Food, Games 
and Adventures, Math and Statistics, Music 
and Sound, Sex, Religion, Utility, etc, They 
even have 16 Eamon Adventures, though 
each is on a separate disk (see Adventure 
Tips, Issue *2, by Mike Flynn). 

The hard-copy catalog of the Library runs 
15 pages, plus there's a very informative 3A 
Press newletter added on . 

So how do you go about buying these 
programs? You don't! These are public 
domain programs. All you pay for Is the fee 
to copy theml And that fee is either S 1 or S2, 
depending on how if s done, If you order their 
pre-copied Media diskettes, you pay only S 1 
plus the cost of the diskette, which varies from 
S2.25 each (for less than ten) and S1 .90 each 
(for fen to 19) to only S 1 .70 each for over 200. 
If you want the volumes copied upon another 
brand, the copy fee is S2 plus the cost of that 
brand of diskette. I strongly suggest you order 
their catalog (S2) even if you're only inter- 



ested in the low-priced products (such as 
diskettes) that they offer. These products 
include diskette supplies such as sleeves, file 
case, labels, hub rings, binder pages, and 
printer paper, ribbons, mailing labels, 
cables, nibbling punch, etc. 

To order, however, you must subscribe, 
but that Is only S3. AAA also sells commercial 
software and hardware at their low prices. 
How can they sell at such low prices? Most 
"dealers" get supplies at a discount of 40 to 
60 percent, and then re-sell at the list price. 
By selling products at almost the original dis- 
count price, most software prices begin to be 
more reasonable. Unfortunately, they've 
received some flak for selling ai such reason- 
able prices, especially from Verbatim. 

(Ron Maleika, the AAA Librarian, said, in 
the 3A Press, "I've returned bad disks to Ver- 
batim for replacement, but they have NOT 
honored their guarantee to replace them! 
Can you believe it? They didn't even have the 
courtesy to return the bad disks. I've phoned 
them seeking to buy their disks directly and 
received a lecture that I'm selling their disks 
too cheaply and they demanded to know 
who was selling them to me at such low 
prices. Why would they want to know except 
in some way to punish their distributors? They 
promised twice to have their distributors con- 
tact me, but no one has called or written. Isn't 
it a shame that some companies get so big 
they can afford to IGNORE us little guys, and 
with impunity?") 

How did AAA get so many programs? 

According to Ron, it began in late 1980. 
"My friend, Jim Hassler, a HAM radio fan, had 
started The Apple Net. It was and is a public 
forum over radio to talk about Applel As a 
result of the radio sessions, Jim began to 
acquire Apple programs from other HAMs. 
Soon he found himself acting as a librarian 
for several scores of programs. As if devel- 
oped, he became swamped with many 
duties, ana since I was at hand and had an 
Apple, I inherited the library. 

"The HAMs continued to contribute pro- 
grams and I expanded by mailing a small 
listing to Apple Clubs around the world I also 
gleaned magazines, etc., and sent a list of 
programs to any address that seemed inter- 
ested in the Apple." 



"As programs were exchanged, the library 
grew and keeps growing at rather an 
astounding rate. Word of mouth is doing the 
rest, i've considered advertising in one or two 
of the good Apple-oriented magazines, but 
I'm afraid the exposure would really swamp 
me." 

This is no longer quite true because Ron 
has some more help. Bill Williams is in charge 
of commercial software. And Helen Williams 
is the corporation secretary. Hardware and 
accessories are handled by Ron Deutsch. 
The Public Domain Library is still run by Ron 
Maleika. As the AAA grows, so does its serv- 
ices and products. 

You can help increase Ron's workload by 
trading public domain software. To make It 
easier on Ron, though, first send a hard copy 
list by volume number of the program titles 
you have to exchange. Include their sector 
lengths. He can then indicate which pro- 
grams or volumes he would like to exchange 
and negotiate exchange rates (how many 
volumes you will get in exchange for your 
programs). After all, he may already have 
some of the programs you wish to exchange. 

What happens when someone 
exchanges a copy-righted program? 

"I offer a token reward to anyone who iden- 
tifies d copyrighted program on one of my 
disks as it is impossible for me to be familiar 
with every one of the thousands of programs 
available for Apple." 

Ron also carefully lists and studies each 
program searching for a copyright state- 
ment. Sometimes he gets "fixed" programs 
or ones where the copyright notice was 
removed. This just makes Ron's Job harder. He 
does have copyrighted programs in the 
"public domain library" but these were con- 
tributed or exchanged by their authors. 

Who uses the public domain library? 

"Not only are Apple clubs big users, but 
also school districts and universities, As 
adjuncts to the Apple Tutorial, public domain 
programs are a way to learn at a small cost. 
Programming techniques from hundreds of 
programmers are available to study and 
emulate. Not to be overlooked, even many 

continued on page 49 



PAGE 16 



PO. BOX 44549 TACOMA, WA 98444 



HARDCORE COMPUTING 3.0 



SOME APPLE-ONLY MAGAZINES. 



It is my firm belief that the greatest user support is 
given, not by the computer dealers but, by the 
many computer clubs. Second to the clubs are the 
numerous computer magazines. And if your local 
Apple dealer doesn't support clubs or doesn't 
carry computer magazines then that computer 
store does not support the user and is merely a 
sales outlet. Since Apple Computer, Inc. now 
depends solely upon local retail outlets as it's only 
direct interface with the users, any store that 
doesn't support clubs or magazines is doing the 
users (consumers) and Apple a disservice. You 
should complain to Apple whenever this happens. 

If I seem to be trying to get you to read other mag- 
azines, it's because magazines are one of the best 
sources of user information. Everyone should sub- 
scribe to at least one of the all-Apple mags now 
available, 

Ideal istically, I'd like all Apple owners to sub- 
scribe to HARDCORE. 

Realistically, however, HARDCORE still has a ways 
to go before it can deliver the volume, variety and 
quality of Apple-info presently delivered by an 
assortment of Apple-mags, 

Therefore I suggest that, if you do not already 
subscribe to the magazines I am going to quickly 
review, you should at least get a copy of each and 
examine them. They are: 

1. NIBBLE 

The Reference For Apple Computering 
RO. Box 325 
Lincoln, MA 01773 

2. International Apple Core presents 
APPLE ORCHARD 

PO. Box 1493 
Beaverton, OR 97075 

3. CALLA.PRLE. 
304 Main Ave., 

Suite 300 Renton, WA 98055 

4. SOFTALK 

1 1021 Magnolia Boulevard 
North Hollywood, CA91601 

5. PEELINGS II 

The Magazine of Apple Software Evaluation 

RO, Box 188 

Las Cruces, NM 88004 

NIBBLE 

Personally, NIBBLE is my favorite mag because it 
really has variety. A glance at their table of con- 
tents will prove my point. It has many features that 
HARDCORE is striving to acquire: 

1. Reader involvement in the improvement of 
listed programs. 

2. Numerous short and informative articles on util- 
ities, aids and tricks. 



3, Several feature program listings, many for 
home/business. 

4. In-depth explanations accompanying every 
listing, 

Call & Apple 
APPLE. Orchard 

While NIBBLE is a fully professional magazine (by 
Micro-Sparc Inc.], some of the other dominant 
Apple mags are actually professionally crafted 
'newsletters,' That word is not meant to be deroga- 
tory. It means that those magazines are actually 
functions or services provided by an often non- 
profit computer club. The two most recognized of 
these publications are Call A.RRL.E and APPLE 
ORCHARD. 

Without going into the purposes of the clubs, etc, 
let me simply say that they often contain many use- 
ful articles on programming, and some really 
excellent material on assembly language utilities. 
Irregardless of their editorial policy (which, as a 
member, you can alter by voting), they are fine 
publications. 

With the entrance of Peter Welglin as the new edi- 
tor (replacing Val Golding, present editor of Call 
A.RRL.E.), APPLE ORCHARD can now compete with 
Call A.PRL.E. As a result, I expect to first see some 
remarkable improvements due to its new, competi- 
tive status. 

Two other magazines have taken the big leap 
into competing with the big pros. They are PEEL- 
INGS II anq SOFTALK. 

SOFTALK 

Originally only an industry "fluff' magazine tell- 
ing who is doing what and who got promoted to 
where, SOFTALK has expanded in size and cover- 
age and is now running major informative articles 
on programming. It is also now charging for sub- 
scriptions. 

PEELINGS II 

PEELINGS II is now typeset and is looking really 
good. The reviews within are incisive and in depth. 
As a professional "House of Software Review" they 
must get nearly all the commercially available soft- 
ware, so I consider PEELINGS II to be THE source of 
software reviews. They are also reviewing firm and 
hard ware. 

Now to round off this Librarian's notes, I would like 
to mention another multi-computer magazine: 

DATACAST 

Software Systems and Telecommunications for 
Users, published Jim C. Warren Jr. and Wireless Digi- 
tal, Inc. 

For more information, write to DATACAST, 333 
Swett Rd., 

Woodside, CA. 94062. 
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GREETINGS- 

In my last column, I mentioned a pro- 
gram called ZORK. No doubt most of 
you have heard of it, or played and 
possibly completed it. 
ZORK 

Zork was originally written on a main- 
frame or very large-scale computer. It 
was converted to run on microcompu- 
ters, but due to its large size, it was split 
into two parts. A third part is being writ- 
ten, but so far I have seen only parts one 
[of which I have a complete map], and 
two. I have heard rumors of part three 
being released very soon, 

The most frequently asked question I 
have received on ZORK is, 'How do you 
open the jewel-encrusted egg?,' The 
answer is that you DONT, Eventually you 
will run Into someone who can. 

Other than that, I won't give any more 
clues in this issue, but I have set up a file 
specifically for the maps and the most- 
asked questions pertaining to ZORK 
(parts 1,2,3 inclusive). 

It seems that there has been a glut of 
adventures since my last column. Let's 
see, there is Cranston Manor, Ulysses 
and the Golden Fleece, Cyborg, 
Wizardry, Goblins, Adventure in Time, 
Castle Wolfenstein, Crush-Crumble and 
Chomp(?), Swordthrustand Zork II, just to 
name a few. On Line Systems has cer- 
tainly been busy with their follow-ups of 
'the Wizard and the Princess,' including 
their first two disk adventures. I have 
also just recently seen On Line's latest, 
something called Time Zone' for S 100. [I 
will give some tips on this one later in this 
colunm.) 
SWORD THRUST 

Donald Brown of Eamon fame has 
presented us with Sword Thrust. This 3- 
disk series has the basic Eamon style but 
has a whole new flavor. 
WIZARDRY 

I have just finished Wizardry As a gen- 
eral impression I must say that this one is 
very exciting, (However, I had to 
exchange my purchased game twice 
before I got a functional copy That was 
probably due to an unreliable protec- 
tion scheme. Other than that, I have no 
complaints aPout the game.) 

I have a complete map of the prov- 



ing grounds of the Mad Overlord and I 
will begin mapping the Knight of Dia- 
monds scenario as soon as it is 

THE PIRATES OF WIZARDOM 

On a different note, i was using an 
A.B.B.S (Apple Bulletin Board Service) 
called 'PIRATE'S HARBOR.' After reading 
some of the public bulletins, I ran across 
the following: 

'THE SUBJECT OF SOFTWARE PIRACY 
HAS BEEN AN OPEN TOPIC OF DISCUS- 
SION ON THE BOARD FOR SOME TIME. IN 
THE MONTH OF NOVEMBER, A PERSON 
CAME ON OUR BOARD WHO CALLED 
HIMSELF 'ROBBING HOOD,' WHO SAID HE 
LIVED AT RISLEY HALL AT CORNELL, WAS A 
SOPHOMORE, AND ALSO HIS REAL NAME 
WAS 'FRED WILLIAMS'. IN EARLY DECEM- 
BER, I FOUND OUT THAT HE WAS REALLY 
SOMEONE FROM THE COMPANY CALLED 
SIRTECH, WHICH PRODUCES A GAME 
CALLED 'WIZARDRY' 

'SOMETIME IN JANUARY, HE FOUND 
OUT THAT WE KNEW WHO HE WAS, AND 
AFTER SOME DISCUSSION DECIDED TO 
'COME CLEAN,' I TOLD HIM THAT HE 
COULD TELL HIS STORY AND THAT WE 
WOULD HAVE AN OPEN DISCUSSION OF 
THE SUBJECT,' 

The preceding bulletin was left by the 
system operator or 'SYSOR' After doing 
a little checking, 1 learned that 'Rob- 
bing Hood' was actually Robert 
Woodhead and that the reason he 
logged on to a pirate's bulletin board 
was to get an idea of the level of piracy 
concerning his program, Wizardry, 

In my opinion, this is one occurrence 
of deception that I heartily condone. 
Wizardry is by far the best game pro- 
gram of any type that I have ever 
played 'bar none', If Mr. Woodhead 
keeps producing software of this cali- 
ber, I will be glad to pay 350.00, or 
S 100.00 for that matter. Needless to say, 
I recommend this program to anyone, 
even if you don't like games of any sort, 

SAVAGE ISLANDS 

Recently I read somewhere about 
certain adventurers complaining that 
Savage Island and Savage Island part 

continued on page 50 
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In the last installment I discussed the char- 
acteristics of adventure mazes and defined 
a "room" as just one step or motion in such a 
maze. This time I'll describe the difference 
between a site and a site's elements, or 
objects. 

Site means location and in mazes a site is 
best describe by those features of a "room" 
that generally cannot be transported out of 
the "room." The things that can be moved 
about are called site elements These are the 
objects that the adventurer can GET. That 
means that the site is merely a locale while 
an element is an object. Most adventurers 
tend to emphasize objects rather than site 
because it is easier to interact with objects. 
After all, ever try to GET a mountain, or DROP 
a river? Site, therefore, is not usually critical in 
the unraveling of most adventure mazes that 
depend heavily upon object possession and 
manipulation Site CAN Pe used more often 
and in much the same way that site descrip- 
tions enhance and project any fantasy's 
world view. Here are a few examples of how 
site should be used: 

v Snow blankets the ground as the blizzard 
howls deafeningly" instead of "you freeze to 
death." 

"The ground rumbles menacingly" instead 
of "you are in a volcano." 

"Your feet splash into mud" in a desert, 
instead of "you sink into quicksand." 

"Acrid smoke chokes you" instead of "you 
are burned alive." 

"A towering shadow looms before you. A 
growl fills the cavern" instead of "a demon 
grabs you." 

With more "story-like" site clues, the adven- 
turer is given the option of resolving the prob- 
lem before an untimely [and often frequent) 
demise. It requires a more complex program 
and results in a far more challenging game. 

This must also apply to hi-res adventures, of 
course. The accompanying graphics should 
be more detailed, and include more motion 
than previous adventures. Nor is it necessary 
to show "top-views" of such mazes in order to 
Incorporate action graphics. A variety of 
viewpoints would be appropriate and wel- 
comed. 

GET GOLD! GET OUT! 

Another complaint ot mine concerns 
game objectives. Gathering objects is sec- 
ond nature to adventurers who learn early on 
that stealing is an acceptaPle way of life for 
any adventurer. However, theft is by no 
means the only way to acquire objects, 
wealth and fame. An adventurer may buy 
them. Bartering for goods can be quite com- 
plex and a vital strategic element. Treasure 
hunting is one of the prime attractions of 
adventures and discovering such a trove 
makes many boring adventures at least a lit- 
tle less of a bore. But what about other means 
of gaining possessions? 

If one doesn't beg, borrow or steal, then 



how does one GET them? Well, the adven- 
turer can create them: forge spearheads 
and swords, string a bow, carve a boat. 
Some adventures require the player to com- 
bine several items to create a new object: a 
rope plus a spear equals a rope bridge to 
cross a narrow gorge. 

Perhaps the adventurer can tame a wild 
animal and thereby gain a loyal and useful 
ally Or an adventurer can accumulate 
knowledge, skill and power instead of a pile 
of gold, weapons, and magical implements. 

Maybe the solution is not through gold at 
all. but rather in the friends and acquaint- 
ance you nurture: not WHAT you know, but 
WHO. 

In fact, a good adventure should use all 
these modes. But keeping track of multi- 
solutions for any game can be very complex. 
To keep the program as small as possible, it 
will be necessary to code all site and object 
characteristics as well as participant charac- 
teristics . This flexibility will allow more than 
one solution to a particular adventure, 
resolving the problem of a single solution that 
often leaves the adventurer lost. 

You should be able to move a sword from 
one room and leave it in another. You should 
be able to hide possessions that you do not 
wish to carry Some objects must be destruct- 
able while others must be capable of being 
combined to form yet another object. And 
still other objects must be "breakable" into 
transportable sizes, or simply removable [like 
jewels from a building). 

CODING INFORMATION 

One way to coae such information is to use 
strings in applesoft. For example, PS(0) would 
consist of the personal possessions and char- 
acteristics of a particular entity such as the 
adventurer. .An example is: 

PS (0) = 'KDSOI :9LJK0450M ..." (230 CHARAC- 
TERS LONG ) 

To find out if the adventurer has a knife, for 
example, the program must go to the knife 
column (let's say that it's in the 30 column). We 
would extract: 

MIDSfPS[0l,30,11. 

Now let's say that the character extracted 
is an "H." That would be a coded symbol for 
something: the knife is broken, and being 
held in the left hand. However, to decode it 
would take a great deal of space. 1 person- 
ally prefer to code all my variables outside of 
Applesoft, that is, directly into a hex or binary 
(0 1 00 1 1B 10) format that I can BLOAD them into 
a running program without using text files. 
The byte (0-255) code for any particular 
adventurer (if more than one) would be 
stored at a specific place in memory and in a 
particular coded manner. With the full 256 
ASCII values available to me in the binary for- 
mat (instead of a mere 85 inside a string), the 
possible combinations are far greater. If the 

continued on next page 
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knife column is still column 30, it could be 
retrieved by a peek [KNIFE) where KNIFE = 
memory location where the knife data is 
coded. Let's say that the byte there is 133. 

To decode it, let's assume that the follow- 
ing general possession coding was used: 



coder value range 



I 

i -25 
26 -31 

31 -73 

7b -m 

lfl - 123 
126 - 151 
151 - 175 
176 -2M 
2fl -225 
226 - 2H 
251 -255 



f 
I 
2 
5 
4 
3 
6 
7 
8 
1 
If 
11 



explanation 

■miitawiiina 

not in possession 
secretly hidden 
special carrier 
in the bag 
pant's pocket 
shirt pocket 
head 

right teg 
left leg 
right are 
left ire 
torso 



CODER X 25 - VALUE RANGE 

lunnuiuiuimiiiiiu iiibii 

If the value Is then the adventurer has no 
knife. If the value is between 226 and 250 
then the knife is in or on the left arm. The first 
part of the code can be obtained by divid- 
ing the PEEKed value by 25. The resulting 
range can then be further decoded into 
more detail. In the case of the arms, addi- 
tional code options would be different from 
the legs or head, etc: 

1 . shoulder 

2. upper arm 

3. elbow 

4. crook of elbow 

5. lower arm 

6. wrist 

7. back of hand 

8. palm 

9. thumb 

10- 13 the fingers 

14-25 additional aetails. 

This part of the coding Is the "remainder." 
In this example, the code was 133. Division by 
25 gives 5 with a remainder of 7. It decodes 
as; The adventurer has a knife In the palm of 
the right hand. 

Knife on right arm = 5 

In palm =.% . 

The Initial coder (divisor of 25) could apply 
to all possessions, while each range would 
have various specific codings. 

it may seem very complex, or a case of 
coded overkill but this allows much greater 
flexibility and realism. Gone will be the single 
solution adventures. 

The command parser would do all the 
work of decoding possession codes and 
reallocating objects and entities. Not only 
must the command parser translate the com- 
mands that an aOventurer enters either by 
keyboard or paddle, but It must also handle 
all possible errors and give appropriate 
reward or punishment for an adventurer's 
creativity in seeking odd-ball solutions when 
all else fails. 

The command parser must be able to use 
single key commands in cases where 
response time is measurea, and still have an 
extensive vocabulary and a language 
algorithm to turn sentences into correct 
action without misunderstanding (or simply 



not understanding). And that is the topic of 
the next installment. 

Meanwhile, here is a more complete listing 
of the Island-Maze maker turned "editor." 
Unlike the original maze-maker which was a 
demonstration program used to encourage 
programmers to look for alternate maze 
depictions, this "map editor" is specific in Its 
graphic presentation (which defines it 
severely). I encourage you to come up with 
your own maze-maker modules. 

$HEX < DENORY BIASRAtt > DECIMAL 

3flj3 ::::::::::»:3u:=:::::: 2848 

:::<Loarfer Prograa>:::;: 



:< Island Data Set>;::: 

B3«aw(!ni™i»;ii= 5128 



2080 

//////////////////////// 

//Hi -Res Page 1 Buffer// 

//////////////////////// 

♦008 ====«====«====«==«»= 10241 

:::<Editor Prugrai)::::: 



: (hi -res page 2 buffer): 



» t * i * i j 



=«■***■«*•»* 



"LOADER" FOR EDITOR 

If D* = CHR$ (4) 

20 POKE 183, 1 : POKE 184, 44 

38 POKE 14304, 

58 PRINT D* "RUN === " 

(«= file naae you SftVEed editor under,) 



To use the Island Map Editor- Displayer, you 
must run its "loader" program first. The 
"loader" resets the "beginning of program" 
pointers to point above Hi-res Page 1 . The 
binary Island Data Set Is stored just below this 
buffer. (See MEMORY DIAGRAM. Notice that 
the Island Data Set resides just below hi -res 
page 1, while the program begins on hires 
page 2) 

EDITOR'S NOTE 

If you already have the RELIEF MAPPER 
1 .0, then all you need to do to turn it into 
the MAP EDITOR is to add in the new 
lines, redo some other lines and make 
small changes in a few others. 

1 . Alt line numbers that are preceded 
by a slash need not be redone. They 
are also used by the MAP EDITOR. 

2. All line numbers that are preceded 
by a dot must be altered a little to make 
it work with the MAP EDITOR. Examine 
the line and edit your tines accordingly 

3, YOU MUST REDO THESE LINE In the 
mapper program because I made 
some alterations in order to put in the 
editor: 

300 through 3913 

10000 through 10012 

The easiest way to do this it to simply 
DEL 300,390 and DEL 10000, 100 12, then 
type in the new lines. 

4, DELete line 10090. 
--BRH 
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Island Map Maker- Ed 



10 SOTO 22080 

SET KEY! OF STROBE 

58 KEYX = PEEK ( - 14384) ! 
127 THEN POKE - 14368,0 
52 RETURN 



IF KEY)! > 



\ 110 RETURN 

\ 130 IF TMEHX < mm. Oft TNENX > EHEHI 

THEN POP : SOTS 2880 
\140 RETURN 



DECODE SITE* TO SITE* <N) 

60 m = SITE!! + 1 ; ON $f GOTO 3080, 

3100, 3208, 3380, 3400, 3500, 3408, 

3700, 3800, 3908 



\200 



- HAKE ELEVATION - 

ELEVX = INT ( PEEK (INErtf) / 10) 
- 10 - INT ( M CI) * (SLOPE?, 
(SIDE) +1)1 - 2 

\ 210 IF ELEVX < 8 THEN ELEVX = 

\240 RETURN 



70 


— SITE TEH NAP SYMBOLS 

St ' '--" ! RETURN 


\250 


N-E-S-W SIDES -—- 

tneiu = ?nm - 20 


71 


St = "II" : RETURN 


\255 


RETURN 


72 


St = •<>■ : RETURN 


\260 


THENX * PNEN2 ♦ 1 


73 


St »»!!": RETURN 


\265 


RETURN 


74 


S* « 'IV : RETURN 


\270 


THEM = ?nm * 28 


/b 


St = "**■ : RETURN 


\275 


RETURN 


lb 


St = *##" : RETURN 


\280 


TNE«i = PHEW - 1 


II 


St » "" : RETURN 


\2S5 


RETURN 


78 


SI * 'W : RETURN 






7? 


St » *«•* : RETURN 




TKCM7 fAirfiliTtriM 



is. uch ruFCK 

\ 180 IF mm < BHEM OR TMEHK > ENENS 
THEN POP : POP : SOTO 1500 



OF X, V, ELEV, & SITE 

300 m = tnem?. - mm 

310 Ytt = Y0X / 20 : m = m 
20 



m * 
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How to use: ISLAND EDITOR-MAKER MAP 



The first thing that happens when you RUN 
the program is that the "Master Menu" is dis- 
played. 

island naze henu 



< * > HERES/ffiMU SNITCH 

< 1 > HAKE KEN ISLAM 

< 2 > ADO HOUNTAINS 

< 3 > EDIT ISLAND DATA 

< 4 > LOAD ISLAND DATA 

< 5 > SAVE ISLAND DATA 

< 6 > EXIT PRU6RAH 

< 7 > DRAM RELIEF HAP 

CHOOSE A NUHBER 

The program Is entirely menu-driven. All 
you need to do is select the proper numPer 
for the job you want done. RUN the program 
now and follow along with this Tutorial. 

First off, lefs make an island. That's not as 
simple as it seems. There is more to making 



an island than you might suspect (or that I sus- 
pected when I started this project). 

Using this program, there are at least 2 
main steps (more If you wish to see it in hi-res 
or if you want to customize it). In order to 
make a complete island, we'll follow these 
steps: 

A. {i} MAKE NEW ISLAND 

B. {7} DRAW RELIEF MAP 

C. {8} HIRES/MENU SWITCH 

D. {2} ADD MOUNTAINS 

E. {3} EDIT ISLAND DATA 

F. {5} SAVE ISLAND DATA 

All the menu choices are independent 
and, if you are in a hurry, you can use this 
short-cut method: 
A {1} MAKE NEW ISLAND 

B. {2} ADD MOUNTAINS 

C. {5} SAVE ISLAND DATA 

Or, if you want, you can repeat some of the 
steps. For instance, you can {5} ADD MOUN- 
TAINS until you get enough. 

LET'S MAKE AN ISLAND RIGHT NOW. 

Press: {1} MAKE NEW ISLAND. 

This subroutine flips to the text page and 
performs the following steps: 

A. It erases the 
island data-set in memory by turning all the 
bytes into 1 24 (line 10020) which is site-type 4 
(meadows) and elevation 2. 



wwn nnr m r r """ ' » | ii ii n n n nln ' ' ln l , " rirlf11 ' iMiujnnnninnindiaananBinDinniBaiuyui JPI 



itor-Hi Res Displayer 



mace 



328 KHAPI = XXI * 13 + YH » 4 - 38 
1 IF MAPI < 8 OH MM > 259 THEN 

POKE THEMX, 1M ,„ ricliV 

35* FACTS > PEEK (THEN*) / 10 ! ELEVK 

= FACT! - If 
368 IFELEVI >B THEN 9WN - 1 
378 SITE! « PEEK (THEM) - FACTI * 18 
308 VHAPI « in * 7 - ELEVX * 13 
398 RETURN 



\ 650 PHEM7. : 

\698 RETURN 



THEM 



NORTH SIDE -— 

\ 588 THEN1 " PflEM + 1 

\ 518 BO5U0 188 

\ 528 ZHEHI - THEM * 28 

\525 IF WIDTH » LIBIT t 2 THEN 2HEHI 

ZHEHK - 1 
\ 538 SOSUB 288 
\ 558 PNEHI = TRENI 
\590 RETURN 



EflST SIDE 

\688 THEH1 « PHENI t 20 

\ 610 SOSUB 100 

\ 628 ZHEHI « TNEHX - 1 

\625 IF NIDTK= LIBIT * 2 THEN ZHEHZ 

mm - 20 
H3f 6GSUB 288 



SOUTH SIDE 

\ 780 TMEH7. = PHEH1 - 1 

\710 SOSUB 180 

\ 728 zhemi = rrienx - 28 TuriiH 

\725 IF WIDTH = LlttlT * 2 THEN ZHEW 

ZHEHI * 1 
\730 SOSUB 280 
\ 758 PHENI * THEN)! 
\798 RETURN 



-- NEST SIDE 

S B88 THEM ■ PMEHI - 20 
\ 818 SOSUB 180 
S B28 ZNEHI ■ THEH7. * 1 
\fl25 IF WIDTH * LIMIT » 

ZHEHI * 28 
\830 SOSUB 280 
N B58 HEM = THEM 
\fl98 RETURN 



2 THEN ZHEM 



B. It randomly places large and small pat- 
ches of site-types all over the data-set. These 
site-types are: 



908 



PNEM 
950 



LOOK AROUND 

THEM : 6SSU8 308 I GOSUB 



continued on next page 



number 


name 


map code 


4 


Meadow 


%% 


S 


Forest 


* * 


6 


Farmland 


#4 


7 


Desert 


£ 


e 


Jungle 


8* 


9 


Swamp 


= = 





Water 


■■ 



SITE PATCHES APPEAR 
== iiumt ****** m*««« 

=% -— tHtlllfl *»* ******==== 

„-— inmmnm ****==== 

#i###h#»** *ih 

-- 8iitii»»==tt itu 

titt iHfcttw— - «■» mm 

mmmm ss — -****** 1 * 

ItUtlttUitDA pmi-mmmfcU 

itHtftftttf —- win --muurn 

ftltttAtttt "« $*** 

mm ait********* ===== hii 

===== U&fc Itttt*'""*" s====s 

— - mm 

— - tt*v 

mm 

This operation is displayed as it occurs. 

C. It then creates the island's perimeter 
and fills in the sea by going in a clock-wise 
direction. You will see this process, too. Those 
areas markea as "-" (water) were changed, 
in the data set, into "100" or "90." 



SEASHORE FORMS 



- t* tm tm— 

„._ tmim- - im - 

H- 3 »===tttt-'t11tlt - 

*HH*="===M " » 

— Mtttl--=»= ItHW— 

»UU»— - «== ** — 

— uttim « — -ttmi— 

mum — HiHi--»*iH- 

4ffcttttktt — -tOHH "l*mtHr 

— umt "** w— 

asiwur-' M »= 

I AAA A J. A AAA A 



-km mk 
-mm mm 
wA-—mk M * A - 

an**** 

-mm 






AAA A A A 
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4. It redraws the entire coded island from 
top to bottom. 



nu nit mi 

m7,-~-'/.mmi umm— 

snm--======m?.--mm 

immn'j."--*"im-im 

— - im«HH--«= 'Ummitmz 

mt&Ufc— ->-« 8 

-— mtuu «im-— turn 

mimki #H«#--«mi™— 

-~:amumn— -stfiitm-mmn— - 

---<immmv!.v*m7.VLW.v.%ii 

'/mmm-^^'-^xnui 

mimm AM ^ M ^ A m-m — 

y.iw.mMm^ : <'* A ^mi===^j.—- 

^"I»?--4I|| MM *SS*«*I : I 

—- u my-*- w "Vai-u — 

■■■ -— mmmi— n - 

ir-'-u — — 

vat — 

5. And finally, it returns you to the menu. 
PRESS {3}EDIT ISLAND DATA 

Now you can edit the island you createa. 
This island has no mountains, yet, so this step 
is for those who want to change the island 
before the mountain-building begins (which 
builds ONLY on the available ground). 

Notice that the island data code is 
rePRINTed on the text page. The flickering, 
clicking cursor in the upper right corner 
(which means you are in the CURSOR MODE] 
can be moved over any part of the islana by 
using the arrow keys to go left and right, the 
{RETURNT} key to go up, and the SPACE key to 
go down. As you move the cursor, the site- 
type ana elevation is displayed just below 
the map. 

Move to the spot you want to edit and press 
the {ESC} key. It will beep, and then display 
the cursor position oniy by flashing it [no more 
nolsel). You are in the EDIT MODE. 

Pressing through 9 will change that site to 
the type you select and then return you to the 
buzzing CURSOR MODE. 

To edit the elevation, press the Asterisk 
key (use the shift). 

The four airections give you the elevation 
on each side of the cursor position, ana the 
cursor's elevation is shown to the right just 
above its site type. To select an elevation, 
press the {SPACE} key until the inverse marker 
moves up the scale (1 - 12) to the elevation 
you desire. Should you exceed 12, the 
marker starts again at 1. Press {RETURN} to 
select the elevation. You will be returned to 
the noisy cursor mode. The elevation, as you 
can see, has been changed, 

If you selected an elevation above 8, the 
cursor will have a different clicking sound. 
Move the cursor aside and you will see why. 
All site symbols marking an elevation above 
8 are in inverse. 

Did you notice that you couldn't select an 
elevation of zero? Actually, you can, but not 
from the EDIT ELEVATION MODE. Go to the nor- 
mal EDIT MODE by pressing ESC while in the 
CURSOR MODE. All you have to do is select 
"IB} WATER." 

To return to the master menu, press "X" 
while in the CURSOR MODE. 
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step 1: A Naked Island... inverse image 



m FOR TEST = l TO 4 : ON TEST GOSUB 
251 241. 27S. 280 : GOSUB 308 ! 
ELEVt = STR$ (ELEVZ) I IF TflEMX ( 
BNENX OR THEftX > EHEff. THEN ELEV* 

ON TEST GOSUB 961, 970, 982, 990 

NEXT : TNEMS » PWEM1 ! RETURN 

INVERSE : VTftB 23 : HTflB 22 : 

PRINT "ELEVATION: " ELEVS \\ VTftB 

24 : HTflB 22 ! PRINT "SITE: " 

SITE* (HHi ;: NOfiffftL 

mi 23 : HTftB 1 I PRINT "NORTH: " 

ELEV* i: RETURN 

VTAB 24 : HTftB 12 

ELEV* i: RETURN 

VTflB 23 : HTftB 11 

■SOUTH; ' ELEV* i : 

VTflB 24 : HTflB 2 : 

ELEV* ;: RETURN 



920 
930 
950 



960 
970 
990 
990 



; PRINT "EAST: 

: PRINT 
RETURN 
PRINT "NEST: ' 



SLOPES FOR EACH SIDE 

\im FOR SIDES = 1 TO 4 ; SLOPES 

(SIDES) = RND (1) M ♦ 1 : NEXT 
SIDES 



- MAKE MOUNTAINS 

\11M fiX > «H0 (It * 3 t 3 : FOR 
MOUNTftlH = 1 TO n 

vim ztipx = rnd m * 400 + wm - 1 

\ 1120 ELEV2 = RND (1) » 5 * 8 

V1130 IF PEEK (mm ( 118 OR PEEK 

flTIPlJ > 180 THEN 1110 
M14I ELEVS = RND (1) » 5 t B 
• 1150 POKE ZTIPI, (Zim Ml) * If * 3 
-1280 FOR LIMIT M TO 4 
M218 mm = ZTIPI - 28 * LIMIT - 

UNIT 
M3» FOR SIDES M TO 4 
M480 FOR WIDTH = 1 TO LIMIT * 2 
x 1418 ON SIDES GOSUB 500. 600, 780, 808 
M43I ZELEV2 = (ELEVX ♦ If) * 10 
M448 IF PEEK tPHENI) < HI THEN 1500 
•1458 IF PEEK (PflEMU < IELEVX THEN 

POKE PHERX, IRin * INT ( RND 

(11*2 + 5) 
M49I GQSUB 2000 
\tm NEXT WIDTH 
M5i0 NEXT SIDE 
\!520 NEXT LIMIT 
\1538 NEXT MOUNTAIN 
'1540 HSR : GOSUB 28800 ; GOSUB 21008 



•1590 GOTO 22800 



M000 
\2005 
N2018 

Mm 

} 2830 
x 2040 
^2845 
\2858 

• 2055 

N2060 
V2080 
N2090 



PLOT. GRAPH. 1 DRAW 

--LINES TO NEN ELEVATIONS 

HC0LOR= 3 

TNEMK = PMEMX : SOSOB 308 

hplot mn, VMftPX : n = mm : 

U = YMAP2 

FOR TEST M TO 4 S ON TEST GOSUB 

250. 260, 270. 280 

GOSUB 138: BOSUB 388 

IF ELEVX > B THEN SNOW = 1 

IF THEftX < 180 THEN 2888 

HC0L0R- 2 : IF SNOtt > 8 THEN 

HCOL0R= 3 : SrJSd = 8 

if abs m - mm > 14 then 

2880 

hplot n.n to irMPz, mn 

NEXT TEST 
RETURN 



3008 

3100 
3200 
3300 
3400 
3500 
3600 
3708 
3800 
3900 



5000 



5010 
5020 
5030 

5048 
5050 



5890 
5200 



SITE DESCRIPTIONS — 
SITE* (NN) = "OPEN MATER. 



RETURN 

SITE* (NN) 

SITE* (NN) 

SITE* (NN) 

SITE* (NN) 

SITE* (NN) 

SITE* (NN) 

SITE* (NN) 

SITE* (NN) 

SITE* (NN) 



'A CASTLE," 
"A TONN." : 
"UNKNOWN." ! 
"ft HEADON." 
"A FOREST. " 
"PARKLAND." 
"A DESERT." 
"A JUNGLE. " 
"A SNftHP." 1 



: RETURN 
RETURN 

RETURN 
: RETURN 
: RETURN 
: RETURN 
: RETURN 
: RETURN 

RETURN 



PRINT SITE INFD 

HOME : POKE 216, : D3 ■ 1 : 

SOSUB 12000 : D3 = : POKE 34, 

20 : HOME : EDIT! ■ 1 

THEN* = SHEM* M : Rfl ■ 1 

HONE : PNEftt = THEN* 

SOSUB 308 : VTftfl 21 : HTAB 33 i 

PRINT "ELEV! " ELEVX i 

NN -- 8 : GOSUB 68 

VTAB 21 : HTAB 13 : PRINT 

PRINT "SITE! ' i! INVERSE \ PRINT 
SITE* (NN) ;: NORMAL 
ON SITE* t 1 60SUB 70, 71, 72, 
73. 74, 75, 76, 77, 7fi, 79 
GOSUB 58 : VTX = 111 M : HTX ■ 
2 f XXI M 
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5213 VIAE VTX : HTAB HTX ! INVERSE : 
PRINT St ?: I = PEEK ( - U336> - 
PEEK ( - 16336) : NORMAL : VTflB 

m : htab m S print s* ;: if 

ELEVX > 8 THEN INVERSE '. I * 
PEEK ( - 16336) ! VTAB VTX I HTAB 

htx ; print si ;; normal 

5221 IF KEYX • 214 THEN GOTO 22*00 

5238 IF KEY! « 141 THEN 5800 

5248 IF KEYX * 155 THEN 5980 

5250 IF KEYX * 149 THEN 5508 

5270 IF KEYX = 160 THEN 5600 

5290 IF KEYX = 136 THEN 5708 

5490 SOTO 5200 



KEY * -«> -- — - 

5500 THEME * TMEMX + 1 

5550 IF THEM!: > EJ1EMI THEN TMEMX 

TMEMX - 400 : PRINT 6* ! 
5590 GOTO 5020 



-- KEY = <SPACE) - 

5608 TttEffX « TMEMX t 20 

5650 IF THEME > EMEMX THEN THEM?. 

TMEMX - 400 : PRINT 6* i 
5690 SOTG 5023 



5950 IF KEYX « 155 THEN GOTO 5020 
5960 IF KEYS « 170 THEN GOTO 6000 
5970 GOTO 5920 

EBI t ELEVATION 

6000 HOttE : GOSUB 900 

6010 VTAB 21 : FOR A = 1 TO 12 I HTAB 

A * 3 : PRINT A ;: NEXT i A ■ 1 : 

NORMAL 
6320 GOSUB 58 I IF KEY* ■ 141 THEN 6070 
6830 IF KEYX < > 160 THEN 6860 
6040 B * A : A = A ♦ 1 : IF A > 12 

THEN ft « 1 : PRINT 6* i 
6053 HTAB B l 3 i PRINT B i 
6060 INVERSE ! HTAB A * 3 ! PRINT A j! 

NORMAL : GGTO 6020 
4070 IF SITEX = THEN 5ITEX = RND (II 

* 5 + 5 
6000 IF A > 8 THEN SITES = 5 : IF A > 

10 THEN SITES ■ 4 
6090 POKE TMEMX, (ft + 10) * 10 + SITE* 

: PRINT 6* Gt 5t i : GOTO 5020 



KEY = C- - 

5700 TttEM = TMEMX - 1 

5750 IF THEM7. < BftEMX THEN TMEMX 

TMEMX +■ 400 : PRINT Gi i 
5790 GOTO 5020 



— - EBIT SITE 

6500 IF ELEVX < 1 AND ESI > 8 THEN 

FACTX = 12 : PRINT 6* 
4510 IF ESX * THEN FftCTX « 10 
6520 TPKX s FftCTX * 10 ♦ ESX 
6550 POKE TMEMX, TPKX : PRINT G* i 
6560 GOTO 5020 



9800 END 



E H B 



580S 
5S50 



KEY = <RETURN> - — 

rMEMX » TMEMX - 28 
IF TMEMX ( BMEMX THCH TMEMX = 
TMEMX t 400 : PRINT G* » 
5890 GOTO 5028 

K£y = CfisCtl 

5988 VTAB 21 : HTAB 1 : PRINT 

"<EDIT MODE)" Gt Gt 6* ;: VTAB 
VTX ! HTAB HTX ! FLASH ! PRINT SI 
51 NORMftL 

5918 VTAB 22 : HTAB 1 I PRINT 

")>CASTLE , " h *4}HEADDIP''' , '7>DESERr ,v 
^9;S«AMP2>T0WN v1 ' r -' l, '5>F0REST^ , '8>J 

mgle^^waters^peeial^^farm* 
""hjelevation^" ; 

5928 GOSUB 53 

5940 IF KEYX > 175 AND KEYX ( 186 THEN 
ESX * KEX - 176 : GOTO 650? 



VARIABLES 

10003 FMX = 

10001 IF Ml > THEN Ml = ! GOTO 

5303 
10305 HOME ; VTAB 10 : HTAB 10 I PRINT 

"CLEARING MAZE MEMORY" : POKE 

216, 
10810 Gt S CHR* (7) : Dt « CHR* (4) 
13011 MAX * 6 
18012 EDITX • 1 
18820 FOR A = BMEMX TO EffEMX i POKE ft, 

124 : NEXT ft 
18021 TEXT : HOME : D3 » 8 i GOSUB 12080 

: GOSUB 13300 
10030 ftA * BMEMX : BB ■ BMEMX * 19 : 

TEST * MAX : GAP » 28 ! FOR IN « 

Aft TO BB ! GOSUB 11000 : NEXT IN 

continued on next page 




step 2: A Flat Island Topography... 



Now let's draw our Island on the hi-res 
page. 

Press {7} DRAW RELIEF MAR When you do 
this, the following steps are performed: 

1 . The hi-res page is displayed and erased. 

2. The screen is turned blue and then dark 
blue. 

3. Black patches appear here and there. 

4. Beeping is sometimes heard. 

The relief map drawing process consists of: 

1 . Creating a sea of blue. 

2. Plotting the black land masses. 

3. Drawing the horizontal lines. 

4. Drawing the "vertical" lines. 

5. Returning immediately to the main 
menu. 

Notice that the vertical relief lines are at an 
angle? That's to give a sense of "perspec- 
tive" to the map, as if you are viewing the 
island, not from directly on top, nor from 
directly In front, but from above, to the front, 
and a little to one side. 

The process, I admit. Is slow in Applesoft 
(so If you have access to one of the many 
applesoft compilers, try compiling the pro- 
gram. See the article on Applesoft compil- 
ers In the Apple Digest.) 

The beeping you sometimes hear occurs 
only when there is a land mass that would 
have plotted off the screen. That particular 
piece of land was, at the sound of the beep, 
being edited out of the island data set and 
replaced by water. 

If you have been following along pressing 
the proper keys, you will have already cre- 
ated an island, played with it a bit with the 
editor, and now have it drawn on the hi-res 
page. 

When you are finally returned to the master 
menu, press {0} HI-RES/MENU SWITCH, and 
then press {2}ADD MOUNTAINS. 

WARNING: If you are not viewing the hi-res 
page when you press {2}, anything drawn 
on the hi-res page will be erased before the 

mountain-building process begins. 

As described in my earlier article, the 
mountain is built around its tip and all lines 
going up to and coming down from any 
elevation aPove 8 are plotted in white [snow- 
capped?). When the process is complete, it 
will clear the page and redraw the entire 
island with new relief lines reflecting the new 
elevations. 

If you are impatient, you can end any step 
by using the RESET key. Then to return to the 
menu, simply RUN it again. The Island data- 
set is not destroyed by RESET because it Is 
stored In binary form Just below the hi-res 
page. Whenever you want to stop any proc- 
ess in the middle, just RESET. 

When the mountain building process is 
complete and you are returned to the menu 
(or you ended It with a RESET, followed by a 
RUN), you can build more mountains, or go 
into the editor, or you can SAVE the Island 
data set. 

Just as an experiment, press {2} while you 
are viewing the master menu. See what hap- 
pens? You are viewing the actual mountain- 
building process in the "raw." Notice how the 
relief lines avoid the water? 

Return to the menu (wait till it's done, or 
use RESET). Now let's edit It again. 
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Press {3}. If you have built any while 
capped mountains, you should now see 
inverse characters mixed among the normal 
ones. Those are your mountains. You should 
also notice a new site symbol: the exclama- 
tion point. It refers to a mountain peak. Try 
editing the mountain. Add in your own moun- 
tains. Surround the Island in a mountain 
range. Put in a huge lake in its center. Create 
huge deserts, slender Jungles, winding for- 
ests. Now is also the time to put in castles and 
towns. 

There are some limitations to the editor 
(which you may remove if you like), and some 
quirks. For example, selection of any eleva- 
tion to cover a site that was formerly water will 
result In the generation of a random site-type 
that Is not water. And selection of water results 



In an elevation of zero. If you select an eleva- 
tion above 8, then a random site-type is also 
generated, When replacing water with any 
site-type, the elevation becomes 2. Finally 
you cannot build land over deep water and 
if you try, nothing will change. 

Use the editor to move through the island, 
customizing it. To return to the master menu, 
press "X" while in the CURSOR MODE, To get 
out of the EDIT MODE without changing the 
site, use {ESC} Oust as you did to enter the EDIT 
MODE. 

SAVE the island data set by pressing {5} 
SAVE ISLAND DATA. If you want to reclaim an 
island previously saved, press {6JLOAD 
ISLAND DATA, 

It's generally a good idea to save your 
island before you edit or add mountains just 



in case you don't like the results. In this way 
you can just retrieve the original island data 
and start again, 

Now that you have built some unique 
islands, what are you going to do with them? 
That is the topic of the next installment: 

THE COMMAND PARSER 

The command module will let you move 
through the Island using both "single-key" 
commands and "sentence" commands. It 
is the command parser that permits the 
adventurer to engage the elements of site, 
object, and adventure! 



step 3 
A Few Mountains... 

M0040 AA ' BB ! BB » BNEH* * 399 I 

* Aft TO SB STEP 20 ! SOSUB 11000 
: NEXT IN 

MM50 AA ■ BB ; BB ■ BHENZ * 380 i 
TEST * MAX : GAP * - 20 ! FDR 
IN ? AA TO BB STEP - 1 ! SOSUB 
11000 : NEXT IN 

Mtaf aa » BB : BB * bhemx : gap = i : 
TEST = MAX : FOR IN ■ AA TO BB 
STEP - 20 : SOSUB HIM : NEXT 
IN 

• IWS0 03 « i : gosub 12000 : goto 
§m 

mm fi* = RND fit * MAX + 1 : IF ABS 

(RZ - TEST) > 2 THEN HIM 
•11022 TEST = RX ; EDSEZ ■ IN * (SAP * 
TEST) : POKE EDBEI. 134 i JS = 
100 : FOR J J = EDSEZ - SAF TO IN 
STEP - GAP I POKE JJ, JS 
11830 JR « RND (11 * 5 : IF JR < 1 

THEN JS * 90 
11050 I ■ JJ : SOSUB 12020 
11080 NEXT JJ 
\lim RETURN 

Tdi5 syiabol ("*) is used to indicate a 
space. Isherr entering this program, just 
type m a space in place of"" . 

- PRINT NAP BACKGROUND ~ 

12000 HONE : VTAB 21: PRINT 

" -WAT ER^^SNANP^iJc JUNGLE"* 

♦FOREST*" : PRINT 

l '"DESERT^n?1EA00r' w i*FfiRN , ' , " wv '; 

>T0Mr % " : PRINT 

")<CASTLE" M SPECIAL SITE" 
12005 VTAB 1 
12010 PRINT CHRt (13) :: FOR I = BNEHZ 

TO EHEMX 
12020 1i = 1 - BHENZ ! YYX = Y0 / 20 I 

lU s Y0 " YYZ § 20 
12030 YTA8 YYZ + 1 \ HTAB 2 UII + 1 

: TX ' PEEK (I) 
12040 TTX = ft / 10 : SITES = U - TTX 

* 10 : ELEVX = TTX - 10 : IF 

ELEVZ > S THEN INVERSE 
12050 ON SITEZ * 1 GOSUB 70, 71, 72, 

73, 74, 75, 76. 77, 78, 79 i 

PRINT 5$ jl NORMAL 
12060 IF D3 THEN NEXT I 




12085 IF D3 THEN D3 = 03 + I : IF D3 > 
20 THEN PRINT CUR* (13) S! 03 = 
1 

12095 RETURN 



13000 

13010 
13015 

13020 

13030 



13040 

13050 
13060 
13070 
13080 

13090 



MAKE LAKES, ETC. 

RZ = RND (1) * 20 + 13 : FOR 
LAKES * 1 TO RZ ! JS » 110 
Mm ■ RND <1> * 400 t BNENX 
SI » AND (1) * 5 t 6 : IF SI > 
9 THEN JS = 100 : SI ■ 
FOR L - TO RNB (1) * 3 * 3 
FOR LL * - RND It) * 2 * 2 TO 
RNO (1) * 2 + 2 : PNEMX * TNEHZ 
+ LL t L * 20 

IF PNEHX < BMEHZ OR PMEMZ > 
EHEMX THEN 13070 
POKE PMEMZ, JS + SI 
I i PMEMZ : GOSUB 12020 
NEXT LL 
NEXT L, LAKES 
RETURN 



• 20000 



V 20010 
20030 
20040 

20050 



— - DRAM ENTIRE HAP — 
m : HC0L0R= 2 : HPLOT 
CALL 62454 1 HC0LQR= ! 
TO 179 STEP 2 ! HPLOT 
279, A : NEXT A 
FOR I « BHEHX TO EHEHZ 
TMEMZ = I I GOSUB 300 
IF ELEVZ « OR SITEX = 
20090 
E = 4 



0.0 : 

FOR A = 
0, A TO 



THEN 



20060 FOR DD » YHAPX - 3 + ELEVZ TO 
YltAPZ + ELEVZ: GOSUB 20100 : EE 
■ EE * 1 : E « E + 1 : NEXT BB 

20070 E = 8 : EE = EE - 1 

200B0 FDR DD a YMAPZ t t f ELEVZ TO 
YMAPZ * 4 + ELEVZ I 60SUB 28100 
: a « EE M : E ■ E - 1 : NEI7 
00 

20090 E£ • : NEXT I : RETURN 

20100 XI « XHAPZ * EE J IF XI - E < 10 
OR XI * E > 265 THEN POKE I, ffl 
: PRINT G* : RETURN 

20110 HPLOT XI - E - 3,DD TO XI t E - 
2, DD 

20190 RETURN 



21000 
21010 



21020 



21090 
21100 



21120 
21130 



— - DRAW RELIEF MAP — 
MM 
FOR A * BMENZ TO BHEMZ 

0ELEVZ = ! 

GOSUB 21180 : 



+ 380 
FOR AA ■ 
NEXT AA, 



STEP 20 

TO 19 

A 

FOR A = 

FOR AA 

SOSUB 21100 

RETURN 

TNENZ " A 

XMAPZ < 

21130 

(COLOR- 1 : IF 0ELEVZ > 8 OR 

ELEVZ > 8 THEN HC0L0R* 3 

IF 0ELEVX ( 1 AND ELEVI ( 1 THEN 

21180 



BHEHX TO BHENZ t 19 : 
TO 380 STEP 20 : 
NEXT AA, A 

* AA ; SOSUB 301 ; IF 
OR XHAPZ > 270 THEN 
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21148 
21150 

ma 

21m 

21190 



IF abs m - 



mm ) H OR ABS 
18 THEM 21132 



If n < 10 OR n i l§ THEN RETURN 

hplot n, n to xwftp?., ymap;: 



22300 A* « "PROGRAM: ISLAND MAKER" : 
GOSUB 22950 : 60SUB 30000 : GOTO 



OELEV?, - ELEW 
* vrtfipx 

RETURN 



a = mm i n 



22400 At = "PROGRAM: MAP EDITOR" : Ml 



- MENU 

22000 TEJfT I HOME : POKE 214, 
22020 SI = CHRt (7) : Dt = CHRt (4) : 

HIRES * 1 
22030 BMENX = 7790 ; EMEN7. = BMENS * 

39? : REM (7790 = tlE6E> 
22040 BASH* « ■' : FOR A ■ I 10 43 I 

DASH* = DASH* + "-" : NEXT 
22100 At ■ "ISLAND MAZE MENU" ! GOSUB 

22950 
22140 PRINT "< > HIRES/MENU SWITCH" 

: PRINT 
22150 PRINT "< 1 > MAKE WEN ISLAND" : 

PRINT 
22155 PRINT "< 2 > ADD MOUNTAINS" : 

PRINT 
22140 PRINT "< 3 ; EDIT ISLAND DATA" 

: PRINT 
22170 PRINT H 4 > LOAD ISLAND DATA' 

: PRINT 
22180 PRINT "< 5 i. 

; PRINT 
22190 PRINT "< 6 > 

PRINT 
22195 PRINT ■« 7 > 

PRINT : PRINT 
22200 PRINT "CHOOSE A NUMBER " 
22210 SET At I IF At - "0" THEN A ft 

: 60T0 22220 
22215 A = VAL (At! ; 3F A < 1 OR A > 

7 THEN 22210 
22220 HOME : ON A M GOTO 22750, 

22300, 22B00, 22400, 22500, 

22400. 22700, 22900 
22230 GOTO 22200 



SAVE ISLAND DATA" 
EXIT PROGRAM" : 
DRAkl RELIEF MAP" \ 



22500 

225S0 
22540 

22570 

22590 
22400 

22450 
22660 

22690 
22700 
22750 



22760 
22800 
22810 
22B50 

22340 
22870 
22890 
22900 



22950 

22990 
30000 



« 1 : GOSUB 22950 : GOSUB 30000 

; GOTO 10000 

At = "LOADING ISLAND DATA" : 

GOSUB 22950 

PRINT Dt "CATALOG" » PRINT 

ENFUT "(FILE NAME') ISLE." ; 

AN* : GOSUB 22353 

PRINT Dt "BLOADISLE." AN! 

\AtlE4E" 

GOTO 22000 

At = "SAVING ISLAND DATA" ! 

GOSUB 22950 

INPUT "FILE NAME: ISLE." } AN* 

PRINT Dt "BSAVEI5LE." AN* 

\AtlE6E,L400" 

GOTO 22000 

HOME I END 

HIRES i - HIRES : IF HIRES ( 1 

THEN POKE - 16297, : POKE 

- 16304. : GOTO 22210 

GOTO 22000 

IF HIRES > THEN HGft 

GOTO 1000 

if m * " 

22000 

ONERR GOTO 22390 

RETURN 

POP ; HOME : GOTO 22000 

HSR : GOSUB 20000 : GOSUB 21000 

: FOR A = 1 TO 1000 : NEXT : 

GOTO 22000 

HTAB 20 - L£N (At) / 2 * PRINT 

At : PRINT DASHt : RETURN 

END 

FOR I * I TO 1000 : mi : 

RETURN 



THEN POP : SDTO 



■ ;-.' ' .: , :, , . ;■:■:■.-.■; 

;;::::;:. .:::■.■..■■.■.:-.:.. V 

■ " :■'.;' '■:'•■■■■":■:]:, ', ■■''.' Y ' ' 

"'iir-'-i ';«wr.VA'' W'M^ 1 """^ /V^".. '*v : ;:::;:j:5ijjS::«S 



a3S* ■**!'*"«; 
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continued from page 5 

authors profit is 500 * [S50-S1QJJ = $20,000. At 
$25 per hour, did the author really spend 803 
hours improving his product? If he only spent 
200 hours, does he believe his effort worth 
$100 per hour? 

In contrast, the most expensive selection In 
the Hardcore Program Library cost $12 of 
which $6 is postage and handling, S4 is the 
author's royalty, and $2 Is the cost of printing 
documentation. Adding a second selection 
increases the cost by only S4, not another 
$12. This is software thafs too cheap to steal, 
Even the maligned folks at Call- Apple offer 
few such Pargains. If the program is copied 
from a friend, the Honor Royalty System 
requires only that the recipient send the 
author a $ 1 royalty The minority of compu- 
te rists who might use a copied program 
more than once and not send In the buck 
would steal at any price. 

Software sellers must realize that over- 
priced products encourage piracy and that 
copy protection only serves to frustrate the 
honest user. I would have thought that a 
major software producer like Apple Com- 
puter, Inc. wouia recognize this. What's the 
best selling Apple word processor? Apple- 
Writer. The best selling assembler? DOS 
Toolkit. Operating system? DOS 3.3. All 
reasonably- priced, we 1 1 -documented and 
easily-archived. Alas, Apple has caved in to 
the fear and greed of independent software 
developers by copy-protecting and price- 
inflating Its more recent offerings. 

The software retailer, a mainstay of user- 
support, gets squeezed from both ends. To 
buy, he must pay stratospheric prices for 
decent software. To sell, he must either drasti- 
cally cut margins or figure how to prepare 
the slow movers for dinner, 

Until the software producers recognize that 
we're in a recession and Inflation is no longer 
an excuse for premium prices, keep both 
hands on your pocketbook. 

John B. Matthews, MD. 

Dayton, OH 

On The Soapbox 

Dear Chuck, 

Here is your check for a year's subscription . 
I hope that there are enough of us to keep 
this excellent and long-needed publication 
alive. 

Do not despair of advertising, even from 
software houses, If the magazine is success- 
ful, your kickoff article on censorship, and 
your other articles on reasons for creating 
backups will eventually be cited as excuses 
for their placing ads with you. Whatever their 
prejudices, they will not miss an opportunity 
to hawk their wares to the largest possible 
community. In fact, some of them might even 
rise to the challenge and revel In possessing 

continued on page 44 
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Speeding Up 
Disk I/O With 

HyperDOS 




At some time or other, most users have 
all noticed that FID will load a file It is 
copying a iot faster than DOS will load 
that same file. (Is everyone back from 
checking?) If FID can do it, why can't 
DOS? 

When DOS loads a file, it calls a gen- 
eral routine that reads a range of bytes 
from the file that Is open, which in turn 
calls the "Fllemanager" to do the 
actual work. The loop for reading those 
bytes in the filemanager Is extremely 
inefficient when it comes to a large 
range of sequential bytes. If the general 
"read routine" was replaced with a dif- 
ferent routine that read the file sector- 
by-sector, as opposed to byte-by-byte, 
a large speed increase would result, 
Enter HYPER-DOS. 

HYPER-DOS will link into the LOAD, 
RUN, BLOAD and BRUN routines. When a 
file is put into memory, the track/sector 
list and the first sector of the program 
are loaded into DOS and a check is 
performed to see If it is the last sector to 
be loaded. If so, DOS will complete the 
LOAD. Otherwise, HYPERDOS will move 
the data to the correct place in mem- 
ory. Each subsequent sector is loaded 
directly into the correct location and a 
check is performed only once per sec- 
tor to see if it is the last sector of the file. 
On the last sector, only the portion of the 
sector that is used is decoded. 

Compared to standard DOS, HYPER- 
DOS offers a speed increase of up to 5 
times for loading Binary and Applesoft 
BASIC files. It does not effect text file or 
Integer BASIC access, nor does it affect 
file save times. 

A 32K file [131 sectors) takes about 30 
seconds to load with normal DOS and 
about 7 seconds with HYPER-DOS. 

All DOS commands are supported 
and it is compatible with most unpro- 
tected programs that run under DOS 
3.3. tn the writing of HYPER-DOS, com- 
patibility with existing programs was the 
number one priority. 

Unfortunately, a choice had to be 



made as to where to put the new load 
routine. The disk format (IN1T) routines 
could be overwritten or the DOS buffers 



i 



could be moved and the routine 
inserted below DOS. Moving the DOS 
buffers seemed the best choice. 



S 



>HYPER-D0S< 



9067- 

80FB- 
88FD- 
00FF- 
03E3- 
B5CB- 
B7F8- 
A702- 
A2EA- 
B7EC- 
B7ED- 
B7F9- 
B7FA- 
B7B5- 
B5C9- 
B7EB- 
AA60- 
AA72- 
A471- 



• 



■J 



1HI 

1010 

10218 
1030 

mt 
list 
ma 

1070 
1075 
1080 
1090 

1100 START 
1110 PTR 
1120 PTR2 
1130 TEMP 
1140 I0B.LQC 
1150 DA.BUF 
1160 RH.BUF 
1170 PRT.ERR 
1318 CLOSE 
1190 RN.TRK 
1200 RM.SCT 
1210 OFFSET 
1220 rtOV.NUM 
1230 NTS 
1240 TS.BUF 
1250 RHTS.VOL 
1268 F.LEN 
1270 B.ADDR 
1280 END. LB 



BY JOHN BR I D6ES 



THIS ROUTINE IS ASSEMBLED TO RUN BENEATH DOS THEN 
POINTERS ARE CHANGED SO THAT DOS KILL REMEMBER THE 
CODE HHEN A DISK IS INITIALIZED. 
INSERT THE ADDRESS OF THE LOAD ROUTINE AT $A*48 
AND THE ADDRESS OF THE "BLOAD" ROUTINE AT JA38C 



.OR *9Cfl PROGRAM ORIGIN 

.TA $888 TARGET ADDRESS FOR OBJECT CODE 

.ES $67 APPLESOFT PROGRAM START ADDRESS 

,m $FB A TEMPORARY ALL PURPOSE POINTER 

.ED PTR+2 POINTER USED IN MOVING DATA 

.ED PTR2+2 USED FOR SAVING THE YREG 

.EG $3E3 RETURNS LOCATION OF IOB IN A,Y 

.11 »B5CB LOCATION TO PUT DATA 

.ED $B7F0 WORK BUFFER 

.ES JA7B2 DOS ERROR PRINTING ROUTINE 

,EQ (A2EA CLOSE FILE IN USE 

.ED *B7EC TRACK CURRENTLY ON 

.IS IB7ED CURRENT SECTOR 

,EQ *B7F9 NUMBER OF BYTES TO SKIP 

.ES $B7FA NUMBER OF BYTES TO HOVE 

.ES 1B7B5 READ IN TRACK/SECTOR 

.EQ *B5C9 BUFFER FOR THE T/S LIST 

.ED $B7EB VOLUME NUMBER OF DISK 

.EQ *AA60 LENGTH OF FILE IN BYTES 

.EQ $AA72 START LOCATION OF BINARY FILE 

,E9 $A471 READ IN BINARY FILE NORMALLY 



9C01- A9 02 
9C03- BD F9 B7 
9C06- A9 FD 
9C0B- 8D FA B7 



1290 * - 

1380 * LOAD AN APPLESOFT PROGRAM 
1310 t 

1320 LOAD LDA 12 LENGTH BYTES ON FIRST SECTOR 



9C8B- 
9C0D- 
9C0F- 
9C11- 
9C13- 

9CI6- 
9C19- 
9C1C- 



A5 67 
85 FD 
AS 68 



85 
4C 

AE 
AC 
4C 



1330 

1348 

1350 

1360 *— 

1378 

1380 

1390 

1400 

1410 

1428 *-- 

1430 EXIT 

1440 

1450 



STA OFFSET 
LDA l$FD 
STA MOV.NUH 



NUMBER OF BYTES TO MOVE 



LDA START PROGRAM START ADDRESS <L0-BYTE> 

STA PTR2 MOVE TO LOCATION 

LDA START+1 PROGRAM START ADDRESS (HI-BYTE) 

STA PTR2M MOVE TO LOCATION 

JMP SCT.LD 60T0 COMMON LOAD ROUTINE 



LDX B.ADDR SET ADDRESS OF BINARY PROGRAM 
LDY B.ADDRM AND GOTO THE NORMAL LOAD 
JMP END.LD ROUTINE IN DOS 

continued on facing page 
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Requirements: 

48K Apple II with DOS 3.3 

To enter HYPER-DOS. boot up a 3.3 



DOS disk and do the following: 

1 . Type CALL-151 return 

2. Type 9DOT:C9 9B return [address of 
highest DOS buffer) 



■**L,^*| 



9C1F- 
9C21- 
9C24- 
9C24- 

9C29- 

9C2C- 
9C2E- 

9C31- 

9C33- 

9C34- 
?C3B- 
9C3A- 
9C3D- 
9C3F- 



9C41- 
9C42- 
9C45- 
9C4B- 

9C4A- 
9C4D- 
9C4F- 



9C51- 

9C54- 
9C54- 
9C58- 

9C59- 
9C5B- 
9C5D- 



9C5F- 
9C40- 
9C42- 
9C45- 
9C48- 
9C6A- 
9C4C- 

9C6F- 
9C70- 
9C73- 
9C75- 
9C78- 

9C7A- 
9C7C- 

7C7E- 
9C81- 
9C83- 
9CB6- 
9C87- 
9C89- 
9C8C- 
9CBD- 
9C8F- 



A9 04 

8D F9 
A9 FB 
8D FA 

AD 72 
65 FB 

AS 73 
85 FE 

AD 61 
C? f 1 

B0 07 

AD 60 
C9 FC 
90 OS 



18 

ADCB 
6DF? 
85 FB 
AD CC 
49 00 
85 FC 



AC FA 
81 FB 
91 FD 
8B 

D0F9 
Bl FB 
91 FD 



38 

A3 FD 
ED F9 
8D F0 
A5 FE 
E9 00 
8D Fl 

18 

AD C9 
65 FB 
AD CA 
85 FC 

A0 0E 

84 FF 
EE Fl 
Bl FB 
BD EC 
C8 

Bl FB 
BD ED 
CB 

84 FF 
Bi FB 






1440 * 

1470 * LOAD A BINARY PROGRAM 

148 £ t 

1490 BLOAD LDA 44 LENGTH AND START LOCATION BYTES 
B7 1500 STA OFFSET 

1510 LDA #*FB NUMBER OF BYTES TO HOVE 
87 1520 STA NOV, Nil* 

1530 t— 

AA 1540 LDA B.ADDR GET MOVE TO ADDRESS (L0-BYTE) 

1550 STA PTR2 
AA 1560 LDA B.ADDR+1 GET HOVE TO ADDRESS (HI -BYTE) 

1570 STA PTR2+1 

15M , 

AA 1590 LDA F.LEN+1 8ET HI -BYTE OF FILE LEN8TH 

1600 CNF II HORE THAN ONE SECTOR? 

1610 BCS SCUD YES, 60T0 COHNDN LQAD ROUTINE 

AA 1620 LDA F.LEN GET LO-BYTE OF FILE LENGTH 

1630 CNP »*FC MORE THAN 252 BYTES? 

1640 BCC EXIT NO, SO LOAD IN NORMALLY 

1650 * 

1660 * BEGIN LOADING SECTORS 

1471 * 

1680 SCT.LD CLC SET UP FOR ADDITION 

B5 1690 LDA DA.BUF SET LO-BYTE OF DATA SUFFER ADDR 

B7 1700 ADC OFFSET SKIP NON-PROSRAH BYTES 

1710 STA PTR FROM LOCATION FOR KOVE (LO-BYTE I 

B5 1720 LDA DA.BUFtl SET HI-BYTE OF DATA BUFFER ADDS 

1730 ADC 0*00 ADD, IN CASE CARRY IS SET 

1740 STA PTR+1 FROM LOCATION FOR MOVE (HI-BYTE) 

1750 « 

1760 * HOVE FIRST CHUNK INTO PLACE 

1770 *- 

B7 1780 LDY KOV.NUff NO. OF BYTES TO HOVE 

1790LOOP1 LDA (PTR),Y HOVE (FROHi LOCATION 

1800 STA (PTR2),Y HOVE (TOO) LOCATION 

1810 DEY SET NEXT BYTE 

1820 BNE LOOF1 DONE? NO. SO GET NEXT BYTE 

1330 LDA (PTR).Y SET THE LAST BYTE (0) 

1840 STA <PTR2),YNOVE IT 

jgjj| g a. 1 

1860 * SET RN.fiUF TO POINT TO CORRECT HEHORY LOCATION 
1870 * 

1880 SEC SET CARRY FOR SUBTRACTION 

IBM LDA PTR2 START ADDRESS OF PRDSRAN 

B7 1900 SBC OFFSET PAGE OFFSET FROM 1ST SECTOR 

B7 1910 STA RK.BUF SET N0RK6UFFER PNTR TO THIS LOC 

1920 LDA PTR2M GET HI-BYTE OF PR06RAH START 

1930 SBC 1100 TAKE CARE OF CARRY OVERS 

B7 1940 STA RH.BUF+1 STORE HI-BYTE OF NORKBUFFER 
1 ? 5I * 

I960 CLC CLEAR ERROR FLAG 

B5 1970 LDA TS.BUF SET ADDRESS OF T/S LIST 

19B0 STA PTR 

B5 1990 LDA TS.BUF+1 

2000 STA PTR+1 

2010 * 

2020 LDY I00E NEXT T/S TO SET 

2030 STY TEMP SAVE POSITION INTO T/S LIST 

B7 2040 LOAD. IT INC RN.BUF+1 INCREMENT THE HOVE TO BUFFER 

2050 LDA (PTfi).Y GET TRACK OF NEXT FART OF FILE 

B7 2060 STA RH.TRK POT IT IN RHTS 

2070 INY SET SECTOR 

2080 LDA (PTR).Y 

B7 2090 STA RK.SCT PUT IN RUTS 

2100 INY 

2110 STY TEHP SAVE YREG 

2120 LDA (PTRI.Y GET TRACK 

continued on page 70 



3. Type 9D0D:9C return (high byte of 
bottom of DOS used by the 1N1T com- 
mand) 

4. Type A3BC:1F 9C return 

5. Type A448:(M 9C return 

6. Type 3D3G return (rebuilds buffers) 

7. Type CALL-151 return 

8. Enter the following HEX code: 



9C00:00 A9 02 BD F9 B7 A9 FD 


?C08:8D FA B7 A5 67 85 FD A5 


9C10I68 85 FE 4C 41 7C AE 72 


9C18IAA AC 73 AA 4C 71 A4 A9 


7C20I04 BD F9 B7 A9 FB BD FA 


7C2B:B7 AD 72 AA 85 FD AD 73 


?C30:AA 85 FE AD 61 AA C9 01 


9C38:B0 07 AD 60 AA C9 FC 90 


?C40:D5 IB AD CB B5 6D F7 B7 


9C48:85 FB AD ZZ B5 49 00 B5 


9C50:FC AC FA B7 Bl FB 91 FD 


9C58:8B DP F9 Bl FB 71 FD 38 


9C60:A5 FD ED F9 B7 BD F0 B7 


?C68:A5 FE E9 00 BD Fl B7 18 


9C70IAD C9 B5 85 FB AD CA B5 


9C78;85 FC A0 0E 84 FF EE Fl 


9C80:B7 Bl FB 8D EC B7 C8 Bi 


9C88:FB 8D ED B7 C8 B4 FF Bl 


9C90:FB CB 11 FB F0 3E 20 E9 


9C9B:9C A4 FF D0 El CB Bl FB 


9CA0:D0 03 4C EA A2 BD EC 87 


9CABIC8 Bi FB BD ED B7 AD F0 


9CB0:B7 48 AD Fl B7 4B A5 FB 


9CBB:SD F0 B7 AS FC 8D Fl B7 


9CC0:20 E9 9C 68 8D Fl B7 68 


9CC8:8D F0 B7 80 2A A0 0C 84 


9CD0IFF B8 50 AA AD 60 AA IB 


9CDSI6D F9 87 8D 3D BE 28 E9 


9CE0I7C A9 08 8D 3D BE 4E EA 


9C£S:A2 A9 00 8D EB B7 20 E3 


9CF0I03 20 B5 B7 B8 01 60 68 


9CF8I68 A2 08 4C 02 A7 00 00 



9. Type 3D0G return 

10. Insert a blank disk 
1 1 Type INIT HELLO 

This disk will now contain HYPER-DOS 
and may be used to Initialize new 
HYPER-DOS disks. 

Some problems have been encoun- 
tered when using HYPER-DOS with 
binary programs. Binary programs 
which load exactly below DOS or relo- 
cate themselves below DOS and 
assume that DOS ends at S9DO0 will 
overwrite the HYPER-DOS code. 

For those who encounter this prob- 
lem, a version of HYPER-DOS that will 
reside inside DOS and overwrite the INIT 
code will be presented. More on that 
next next time. 
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A New 

Column 

Examining 

Applesoft 

BASIC 



8ev. R. Halght 



part 1 Normal Keyboard Entry 



KEYS TO THE KEYBOARD is the begin- 
ning of a TUTORIAL on Applesoft Pro- 
gramming Techniques. In this 
installment, normal keyboard entry is 
explored. 

There are three ways to retrieve data 
from the keyboard while in the 
deferred mode (inside a RUNning 
Applesoft program): 

1 . Use INPUT 

2. Use GET 

3. PEEK (-16384) 

Of course, you could use non- 
keyboard retrieval via game controls, 
the DOS EXEC command, BLOADing 
binary data, etc, But those are topics for 
other stuaies. I will examine only the 
former three means: INPUT, GET, and 
PEEK (-16384). 



1. INPUT 



ING 



The INPUT statement is usually the first 
method we (earn to use. it permits us to 
input o name, phrase, and a whole set 
of individual or grouped keyboard 
data (when followed by a press of the 
Return key). And the response is printed 
to the screen so that the input can be 
checked and corrected before finally 
being entered with a press of Return. 

It could be something as simple as: 

10 INPUT A $ 
20 INPUT A 
30 INPUT A% 

Or something as complex as; 

40 INPUT AS, BS, C, D%, ES, FS, 6, H 

And it allows us to use our own 
"prompting statement': 

50 INPUT "WHAT IS YOUR NAME, AGE, 
BIRTHDAY, HEIGHT, AND WEIGHT?'; 
NAMES. AGE, BIRTHDAY, HEIGHT, WEIGHT 



It is the ability to easily accept compli- 
cated strings as well as serial data (and 
its re-prompting characteristic) that 
makes INPUT so flexible. 

For example: 

60 INPUT "PICK A NUMBER"; A 

will prompt you with: 
PICKANUMBER 

And if you should answer with any let- 
ter (except E), it will simply give you an 
error message of "7REENTER" followed 
by the same prompting string: PICK A 
NUMBER. 

You can use: 

70 INPUT "prompting statement"; A 

(which demands a number, and may 
Include exponents, decimal fractions, 
positive or negative...} 

80 INPUT "prompting statement"; A% 

(which demands only integers.,.) 

90 INPUT "prompting statement"; AS 

(which demands any string at all,..) 

However, using INPUT requires some 
care because: 

1. Error messages can scroll the text 
page and might destroy the carefully 
formatted displays many programs 
require. This is easily prevented by con- 
trolling the dimensions of the text win- 
dow while an INPUT is operating or by 
controlling the error messages with an 
ONERR GOTO statement. 

2. Formatting can also be destroyed 
when the operator/user invokes the 
editing features (escape codes) and 
may lead to some confusion as to what 
is being asked by the INPUT statement. 
This is especially disconcerting when 
using multiple requests in a single INPUT 
statement. Using serial INPUTs in place 
of a multiple one can solve some of the 
problems. 

3. The error messages are simple and 
do not really explain what was wrong 
with the prior response. These error mes- 
sages consist of: 



7REENTER or 7EXTRA IGNORED (which 
will not stop the program) 

or even the dreaded: BREAK IN LINE * 
(which just stopped the program). 

Table 1, "INPUT" shows what happens 
when you respond to that prompt in var- 
ious ways. It shows that PRINTIng the 
response can sometimes lead to unde- 
sirable results. If DOS is active. DOS com- 
mands preceded by Ctrl D will be valid 
DOS commands when PRINTed and will 
be attempted, so beware of answering 
with: 

ctrlDINITt 



Some things to rememDer about 
INPUT are: 

^. A question mark is used as a 
"prompting" marker if you do not spec- 
ify your own prompting "string" or state- 
ment. Only one string is allowed and tt 
must be followed by a semicolon (;) and 
the variable(s). 

2. Be sure to ONERR GOTO a line that 
RESUMES before going back to the 
INPUT or else the 86th error may crash 
your program. 

3. DO NOT USE Ctrl X, Ctrl M (Return) or 
a quotation mark (") inside a prompting 
string. 

4. DO NOT USE Ctrl X, Ctrl M (Return), 
comma (,) or colon (:) inside a response 
to: 

100 INPUT "prompting string"; AS 

A Ctrl M (or Return) is interpreted as 
"end of string input" even when nothing 
has been entered (in which case a 
"null" or empty string is assumed ). 

5. If the INPUT statement Is not fully 
answered (as in a multiple INPUT such 
as: 

110 INPUT MO$,DAY%,YEAR 

then double question marks are 
printed to prompt you to complete the 
answer, 
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6. Ctrl C can stop an INPUT If it is the 
first character typed, To continue, you 
must then reRUN the program. So 
beware. Ctrl C will NOT stop a program 
If It is preceded by any other response. 
Nor will Ctrl C stop a multiple INPUT state- 
ment when it is entered as the first char- 
acter to any but the first variable 
response, 

Of course, the type of variable will 
affect the nature of the response 
accepted. This is clearly seen in table 1 , 
"INPUT." 



2. GET 



ING 



The second method, most often used 
for single-key selections because It 
doesn't require the pressing of Return, is 
the GET statement. 

A word of warning 

GET was meant to retrieve a string 
variable, that is, a letter of the alpha- 
bet. It was not meant to GET arithmetic 
variables. If you GET A or GET A%, and a 
non-numeric key is pressed, the pro- 
gram may crash with a resounding 
"beep!" and a 7SYNTAX ERROR. And if 
you try to bypass the error with an 
ONERR GOTO, the program may crash 
after the 43rd error. Using ONERR GOTO 
and then RESUME isn't much help either. 
It will crash after the second error. GET- 
tlng a colon or comma will lead to 
7EXTRA IGNORED, GETting a Plus or 
Minus sign, Space, Period, E, and Ctrl 
"at" sign all are valid but equal to zero, 
A Return is like any non-numeric 
response and ends with 7SYNTAX 
ERROR. 

DON'T GET A 

If you must GET a number, first GET AS, 
then change the string into a number 
using A = VAL [AS]. 

GETting a string can also result in a 
few odd responses. A Ctrl H (left arrow 
key), ctrl "at" and Ctrl M (Return) all 
equal a null character (empty string). 
Ctrl C at this time does not stop the pro- 
gram. 

DOGETA$ 

Use table 2, "GET AS," to determine 
what happens when various keys are 
pressed. The table shows the key 
pressed in the right-most column. Fol- 
lowing it are: ALONE or when only that 
key is pressed, when the SHIR key is also 
used, when the CONTROL key is also 
pressed, and finally when BOTH the shift 
and control keys are pressed, Each 
column shows first what you get when 



you PRINT AS followed by the ASCii 
value of the keys' combinations (what 
you get when you PRINT ASC(AS), 

The two columns on the right shows 
what key corresponds to a particular 
ASCii value, Values 1 through 30 are 
control characters and not printed to 
the screen. Some control letters, when 
PRINTED, result in certain operations 
(see the notes in table 2). 



Some characters cannot be directly 
gotten from the keyboard. These 
include the underscore (95), left 
bracket (91) and the back slash (92), 

And trying to PRINT ASC (AS) of a shift ctrl 
"at" will stop the program with 7ILLEGAL 
QUANTITY ERROR IN line number #. 

In order to use GET to get an entire 
string, it is necessary to use concan- 



INPUT 



USER RESPONSE PR06RAN RESPONSES 

ICSSE=ISI C=E BXS I1BE8XXI EIB BBSS I33BI BX S BIB BBSS BS3B ESSB BBBB3XBE BGSBS3 EE3B EX» E3IXI 

INPUT A or AX PRINT A PRINT AX INPUT At PRINT At 






-ok- 


immm 


-ok- 


1234367B9 


-ok- 


lllillllll 


-ok- 1. 


11223344556677 -ok- 1. 


+ 


-Dk- 


- 


-ok- 


. 


-ok- 


t 


?EXTRA IGNORED 




textra 1 SNORED 


HiW 


7REENTER 


7REENTER 


1-H'tM 1 ! 


7REENTER 


-1 


-ok- 


-1-1 


7REENTER 


+9 


-ok- 


+9*9 


7REENTER 


1+t 


'REENTER 


i 


-ok- 


IS 


-ok- 


-E 


-ok- 


-E7 


-ok- 


ma 


-ok- 


4£*4 


-ok- 


mi 


-ok- 


6E-4 


-ok- 


iE-2 


-ok- 


.2 


mm I6NQRED 


i.2 


7EXTRA I&NORED 


1:2 


'EXTRA IGNORED 


1111 


-ok- 


.999999999 


-ok- 


,9999999999 


-Dk- 


.9.9 


7REENTER 


->->->5 


-ok- 


A8CDEF6HIJ 


7REENTER 


1A 


7REENTER 


Al 


7REENTER 


Ctrl S 


7REENTER 


Ctrl 3 


7REENTER 


Ctrl C 


<see note C> 


ctrl S ctrl C 


Ctrl K 


\ 


Ctrl H (Returnt 7REENTER 


Ctrl D ctrl 7REENTER 


Ctrl D (tot* D) 7REENTER 





9 

123456789 
t.llIlllltlEt09 
1.12233446E+17 


9 
9 
9 
(nothing) 
(nothing) 
(nothing) 

(nothing) 

9 
(nothing) 
(nothing) 



I 

6E+10 

m 
him 

.06 


1 
1 

mi 

.999999999 

1 
(nothing) 

5 
(nothing) 
(nothing) 
(nothing) 
(nothing) 
(nothing) 
(nothing) 
(nothing) 
(nothing) 
(nothing) 
(nothing) 
(nothing) 



9 


(see note 
(see note 
(see note 



I 






(nothing) 
(nothing) 
(nothing) 

(nothing) 

9 
(nothing) 
(nothing) 

9 

9 

9 

9 
(see note 
(see note 

600 
(see note 





1 

1 
Hit 



1 
(nothing) 

w 

(nothing) 
(nothing) 
(nothing) 
(nothing) 
(nothing) 
(nothing) 
(nothing) 
(nothing) 
(nothing) 
(nothing) 
(nothing) 



-ok- 
-ok- 
-ok- 
-ok- 

-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-efc- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
-ok- 
(see note C) 
7REENTER 



VvffvuvvVuv 

123436789 
ItlllllHl 
11223344356677 

+ 



\ 

7REENTER 
-ok- 

-ok- 



(■)('«»»! 

-1 

-1-1 

n 

+9+9 

1+2 
E 

+E 

-E 

-E7 
6E+10 
6E+4 
6E+2 
6E-4 
6E-2 

4 

1,2 

1:2 

1111 

.999999999 

.9999999999 

.9.9 

3 

ABCDEFBHIJ 

1A 

At 

(bell) 

(line feed) 

(nothing) 

(nothing) 

(nothing) 

(nothing) 

(tee note B) 

(see note S) 



:9:i::i::Eci[3:::::ttiE:i::tiiiEtiitii:Eii:iiiiis!E3:::::i:::: 

A. prograi stops with 7ILLE6AL QUANTITY ERROR IN line nuiber. 

B. prograi stops with 7SVHTAX ERROR BREAK IN line nuiber. 

C. progru stops with 'BREAK IN line nuiber. 

D. DOS cotiands are valid if proceeded by ctrl D. 

-ok- leans that it is a valid entry and *as acted upon, 
(nothing) leans that nothing was printed 
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tenation. For example, a simple (but 
error-prone] loop would be: 



SETTER 1 



9 RBI RETRIEVE ONE CHARACTER 



Table 3, "PEEK -16384," is similar in for- 
mal to table 2 except that it shows val- 
ues at that location in memory followed 
by what happens when you PRINT 
CHRS(A)whereA = PEEK (-16384) and IF 
A > 127. Values of 128 through 159 are 



control characters, Again, the left 
bracket, back slash and the under- 
score cannot be directly keyed. And 
like GET, you must provide a loop in 
order to acquire a long string or state- 
ment. 



If BET ft* 

1? RED IF KEY PRESSES IS SIGHT ARRQN 
AND IF B« IS HORE THAN A SINGLE 
CHARACTER THEN DELETE THE LAST 
CHARACTER 

2f IF M ' CNR* 0) AND LEN (B*> > 1 
THEN it -" LEFT* m, LEN (Bt) - If i 
PRINT A*' "A* f: 

29 REN IF KEY PRESSED IS RIBHT ARRON OR 
A RETURN THEN HEN Bt 

3# IF At = CHRt (8) OR A* = CHR* 03) 
THEN PRINT At' " : II ■ " : BQTQ 10 

3? REH BET RID OF THE REST OF THE CTRL 
CHARACTERS 

4f IF ASC (At) < 32 THEN A* * " 

49 REH ADD CHARACTER TO K. PRINT THAT 
CHARACTER 

5f Bt > Bt H to : PRINT At ; 

57 REH CONTINUE WITH STRING RETRIEVAL 

60 GOTO If 



£:a&»s:c:s 






This routine will not permit control 
characters into BS and it traps out 
Returns. The left arrow can still be used 
to remove characters from BS . 

As we have seen, both INPUT and GET 
will temporarily halt program execution 
while waiting for something from the 
keyboard, INPUT requires a Return, GET 
does not. 



3. PEEK 



ING 



If we want the program to continue 
while waiting for something from the 
keyboard, we should simply PEEK (- 
16384) or (49152), If the value returned is 
greater than 127 (the high-bit is set) then 
a key has been pressed, in which case 
you should Immediately clear the key- 
board strobe by a PEEK (-16368) OR 
(49168). You can also POKE anything 
there because all that you need to do 
to "clear" the keyboard is to make a ref- 
erence to that location (-1 6368) and the 
value at -16384 will drop by 128 (the 
high-bit is no longer set). 



^t^t^a^^ g ^ i ^^ t ^^ a^^a^a ^ a^ ^ a^^K^e ^^^t^s^ a:^^!^ 



ALONE 



GET A$ 

SHIFT CONTROL BOTH | 



BOTH 



At ASC (AD At ASC(At) At ASC I to) At ASC (At) 



49 
50 
51 
52 
53 
54 
55 
54 
57 



58 
45 
59 
44 
46 
47 



.48. 



33 
34 
35 
36 
37 
38 
39 
40 
41 



49 
50 
51 
52 
53 
54 
55 
56 
57 



42 
61 
43 
60 

62 
63 



58 
45 
59 
44 
46 
47 



SPACE 



.21. 

.32. 



RETURN 13. 

ESC .,.,....27, 
A A 65 
66 
67 
63 
69 
70 
71 
72 
73 
74 
75 
76 
77 
78 
79 



C 

D 
E 
F 
G 
H 
I 
J 
K 
L 
H 
H 

P 
D 
R 
S 
T 
(I 
V 
W 
X 
Y 
I 



81 
82 
83 
84 
85 
96 
B7 

as 

39 



C 
D 

£ 
F 
8 
H 
I 
J 

K 

L 
} 

A 



a 
ft 

3 
T 

U 
V 

K 

y 

I 



65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 
76 
93 
94 
79 
64 
81 
82 
83 
84 
85 
06 
87 
SB 
89 



> ( 

> < 
\ i 

') ( 

> ( 
) \ 

>bell< 
see a 

> ( 

see h 

> ■: 



see 



') i 

\ r 

> i 

> < 

see e 

> i 
} < 

> I 

'}■ ( 



j 
6 
1 
8 
9 

10 
U 
12 
13 
14 
15 
16 
17 
18 
I? 
20 
21 
22 
23 
24 
25 
26 



33 
34 
35 
36 
37 
38 
39 
40 
41 



42 
61 

43 
8 

62 
63 



> { 

> { 

> i 
) ( 
';■ } 

>be!l< 
see a 

see b 

> ( 
) ( 

see c 

> < 

> ( 
see i 

> I 

> i 



see e 



j 
4 

5 

6 
7 
B 

10 

11 

12 

13 

14 

15 

16 
i? 

IB 
19 
20 
21 
22 
22 
24 



m 

">A< 






i 












that, when PRINTed 
a space 



> ( 26 
to the screen, nothing gets 



m 




> < indicate 
printed, not even 

a. CTRL H and Shift CTRL H are the sane as the backspace key <.(--) 

b. CTRL J and Shift CTRL J are line feeds (moves down one line!, 

c. CTRL N is the saite as a RETURN (goes to beginning of nest line) 

d. Trying to get the ASCI) of a Shift CTRL P will end up in an 
ERROR. 

e. CTRL U and Shift CTRL U are the saite as the — > key. 
GETting a CTRL C will not end the program. 



~MAEttr 



PO. BOX 44549 TACOMA. WA 98444 



HARDCORE COMPUTING 3.0 



KEY PEEKER 1 is just such a subroutine: 

mttmut key peekeh t tmtmmmt 

1 ONERR 60TQ 1028 

If B$ * " : 8* = CHR$ (7) ; It » CHRt 

(136) : St • CHR* (32) : S » -16336 

j SOTO UN 



mmtm peeker subroutine mmmtt i» 



Iff A ■ PEEK (-16384) > : IF A < 128 

THEN RETURN 
118 POKE - 16368, i At » CHR$ (A) 
120 IF A * 136 AND LEN (Bt) > 1 THEN 61 

= LEFT* 18$, LEN (B$) - 1) : PRINT 

mmim •. : gosub 200 > return 





























IE 


El 


Iff 


4 


10 


k 4 


on 








P 


V 


El 


I 


-1 


IE 


»3 


B4 




1 






















1 




ALONE 


SHIFT 


CONTROL 


BOTH 






i 


KEY 


VALUE'CHR* VALUE CHRt VALUE CHR** VALUE CHftt ! 


\ VALUE CHR* 






1 ! 


"w~ 


1 


161 


I 


177 1 


161 


1 ! 








2 ' 


178 


2 


162 


■ 


178 2 


162 


11 


t 128 >S< 


173 


_ 


3 1 


179 


3 


163 


1 


179 3 


163 


# 3 


i 129 >A< 


174 


. 


4 $ 


188 


4 


164 


t 


180 4 


164 


t 1 


► 138 >B< 


175 


/ 


5 X 


181 


5 


165 


I 


181 5 


165 


* ! 


► 131 >C< 


176 





6 & 


182 


6 


166 


£ 


182 6 


166 


* 


J 132 M 


177 


1 


7 ' 


183 


7 


167 


i 


183 7 


167 


f 


133 >E< 


178 


2 


8 < 


184 


8 


168 


( 


184 8 


168 


( I 


1 134 m 


179 




9 ) 


185 


9 


169 


1 


185 9 


169 


) j 


> 135 >G< 


180 


4 







.176. 












* bell 


181 


5 


: t 


186 


1 
t 


170 


1 


186 : 


170 


t ! 


[ 136 >H< 


182 


6 1 


- 1 


173 


- 


189 


= 


173 - 


189 


= 1 


( / 


1B3 


7 : 


! * 


187 


; 


171 


+ 


187 i 


171 


+ ( 


* 137 *m 


184 


8 ! 


< 


172 


1 


188 


< 


172 


188 


< ! 


! 138 >J< 


185 


9 1 


. > 


174 


■ 


190 


> 


174 . 


198 


1 ! 


> line feed 


186 


; 


/'? 


175 


1 


191 


? 


175 / 


191 


? 1 


1 139 >K< 


187 


. 1 
1 


<-- 

--> 




..149 












► 148 >L< 

141 >N< 


188 
189 


i ! 












9PACI 
RETU 

A 


m..„ 


..141 

A 












t RETURN 
1 142 >N< 
! 143 >0< 
144 >P< 


190 
191 
192 
193 


> : 

3 ! 
A i 






















193 


193 


A 


129 >A< 


129 


>A< ! 


B 


194 


8 


194 


B 


138 >B< 


130 


>B< i 


1 145 >9< 


194 


8 


C 


195 


E 


195 


C 


131 >C< 


131 


>C< « 


> 146 )R< 


195 


E ! 


I) 


196 


D 


196 


D 


132 >D< 


132 


>B( J 


J 147 >S< 


196 


G ! 


E 


197 


E 


197 


E 


133 >E< 


133 


>E< ! 


148 >T< 


197 


£ 


F 


198 


F 


198 


F 


134 >F< 


134 


>F< < 


i 149 MK 


198 


f ! 


G 


199 


G 


199 


G 


135 >6< 


135 


>g< ; 


i — -> 


199 


8 : ! 


H 


200 


H 


200 


K 


136 >H< 


136 


>H< 


, 150 >V< 


208 


H 1 


J 


201 


I 


201 


I 


137 >I< 


137 


>I< 4 


151 >N< 


201 


i ; 


202 


J 


202 


J 


138 >J( 


138 


>J< < 


i 152 m 


282 


J ! 


K 


203 


K 


203 


K 


139 >K< 


139 


>K< * 


• 153 >Y< 


283 


K ! 


L 


204 


L 


204 


L 


140 >L< 


148 


>L< 


! 154 >Z< 


204 


L 1 


H J 


205 


H 


221 


1 


141 >H< 


157 


>K 4 


! 155 ESCAPE 


205 


I : 


N A 


286 


N 


222 


A 


142 >N< 


158 


> A < « 


i 156 X 


206 


N ! 





207 


D 


207 





143 >0< 


143 


>0< ! 


» 157 >]< 


207 


1 


PS 


288 


P 


192 


i 


144 >P< 


128 


>S< I 


158 >*< 


20S 


p ; 


S 


209 


B 


289 


a 


145 >6< 


145 


>B< « 


» 159 > < 


209 


5 


ft 


210 


11 


210 


r 


146 >R< 


146 


>R< ■ 


1 160 SPACE 


210 


ft ! 


S 


211 


S 


211 


s 


147 >S< 


147 


>S< J 


: i6i i 


211 


S 1 


T 


212 


T 


212 


T 


148 >T< 


148 


>T< ! 


162 * 


212 


t ; 


y 


213 


U 


213 


u 


M9 m 


149 


XK * 


» 163 1 


213 


u I 


V 


214 


V 


214 


V 


150 >V< 


150 


>V< J 


! 164 * 


214 


V 


i 


215 


N 


215 


H 


151 M 


151 


>K< ! 


165 I 


215 


N 


1 


216 


I 


216 


X 


152 >K< 


152 


>I< i 


> 166 & 


216 


K 


Y 


217 


Y 


217 


Y 


153 m 


153 


>Y< « 


► 167 ' 


217 


Y 


Z 


218 


I 


218 


I 


154 >U 


154 


>z< ; 


1 168 ( 
I 169 ) 


218 
219 


I 


ttl cannot be directl 


f keyed; 






t 170 t 
» 171 * 


220 
221 


m 

3 


219 




left bracket 








172 , 


222 
223 


A 


220, 


156 


back slash 












ttl 


223, 


159 


underscore 

















140 

158 
160 
190 



IF A = 136 THEN PRINT I$S*S$ 
GOSUB 218 : B* » " : RETWW 
IF A * 141 THEN PRINT S$A* : 
210 ; B* = " : RETURN 
IF A < 160 THEN RETURN 
B* = B* t At : PRINT A$ ; 
80SUB 220 i RETURN 



tmmnmu tap tap ! mmmmm 



200 FOR A = 1 TO 10 
PEEK iS) : NEXT 

218 PRINT Bt; 

220 H * PEEK m * PEEK 
t PEEK (S) : RETURN 



N * PEEK i$i - 

RETURN 

(S) t PEEK (S) 



mmmtsHiffitERiNG cursor ttuttmitt 



1000 HONE 

1010 VTAB 18 : HTAB 

1020 PRINT "-'Zt ; : 

1038 PRINT "<"Zt ; : 
1840 PRINT StZt ; i 
1050 GOTO 1020 



1 : CALL -860 
6QSUB 108 
50SUB 180 

GOSUB 100 



This shows how program execution 
can continue while periodically check- 
ing to see if a key has been pressed. In 
this case, the time between each key- 
press is used to animate a "shimmering 
cursor" consisting of intermittently PRINT- 
ing a "less than" sign and a dash (lines 
1020-1040). This version accepts only 
non-control characters. Return (line 
140) is used to scroll to the next line, and 
the left arrow key is used to back up 
over mistakes (line 120), and backing 
up over all the entries is the same as a 
Return (tine 130). 

An optional "key tapping sound" has 
been included (lines 200-220) with an 
extra beep for a Return. 

non-scrolling key PEEKer 

If you don't want scrolling to occur, 
make these changes in the program: 

mmmm key peeker 2 mtmimm 



DEL 130, 140 



130 



IF A 
210 ; 



' 136 OR A 
Bt « " : 



■ 141 THEN 6QSUB 
POP : GOTO 1010 



:=S35S3s:==ii::::S3:SK»i:j5ii=ss 



Don't give in to the temptation to 
speed up the PEEK routine by making K 
=> -16384 so that you can simple and 
quickly PEEK (K). If you do, you will lose 
the "shimmering" cursor effect. 

There you have it: part one of KEYS TO 
THE KEYBOARD, 
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Requirements-. 
APPLE II with 32K or 48K 
DOS 3.2, 3.2.1 or 3.3 
Applesoft In ROM 

MENU HELLO is a user-oriented pro- 
gram easily modified for individual 
needs. A menu Hello program Is one 
fhat makes "turn-key" operation possi- 
ble by providing a quick, simple and 
user-friendly way to LOAD, RUN, BLOAD 
or BRUN programs on a disk, 

Most users have probably written a 
menu program of some sort, such as: 

10 PRINT "1) DISKVIEW10" 
2©PRINT"2)D1SKEDIT2.5" 
30 PRINT: INPUT "RUN "; A$ 
40 PRINT CHR$(4) "RUN" AS 

This is great for a few programs on 
selected diskettes, but writing a new 
menu program for each disk can be tir- 
ing at best, and probably not worth it 
anyway. MENU is a more advanced 
type of menu program that allows the 
user to do a multitude of things with the 
directory (where DOS stores all the infor- 
mation printed when a CATALOG is 
done), from LOADing a program to 
LOCKing or UNLOCKing some or all of 
the programs on a disk. 

Type the listing for MENU in the order 
explained in "How To Enter MENU," SAVE 
the program. If MENU Is used for the 
"Hello" program, be sure that it is the 
one that RUNs first when the disk is 
booted. Do this bySAVEIng MENU under 
whatever file name that is RUN when the 
disk boots, or INITialize new disks so that 
MENU is its "HELLO" program, This can 
be done by simply typing INiT MENU, fol- 
lowed by a V and the volume number 
desired (1 -254). 

Now RUN it, "READING CATALOG" will 
be visible in the center of the screen. At 
this time MENU is reading the catalog. 

PAGE 32 



After a few seconds the first part (page) 
of the catalog will be seen. 

To "page" thru it (when there are a lot 
of files In the catalog), use the left and 
right arrow keys. 

To select a program, just type its letter 
code. This will cause the MINI-MENU to 
be entered. The MINI-MENU is self- 
prompting (it asks all the questions) and 
simple to use, 

The only confusing part that may arise 
is when a binary file is RUN or LOADed. 
The MINI-MENU will ask for the RUNning 
or LOADing location. This is an optional 
choice. To LOAD or RUN the binary file at 
other than the original address, enter 
the new address. Press return to use the 
original address. 

REMEMBER: Always precede a hex 
location with a "S". 

It is possible to DELETE, RENAME, 
UNLOCK, LOCK, LOAD (BLOAD), RUN 
(BRUN) a program ana EXEC a file 
(depending on its type) using the MINI- 
MENU, The MINI-MENU also automati- 
cally updates the options for the user, 
This is done so that a locked file is not 
locked again, and a text file isn't RUN or 
LOADed. There is even an UNLOCK/ 
LOCK ALL mode that will LOCK or 
UNLOCK every file on a disk. Whenever 
a file is selected, all valid commands 
are displayed along with their explana- 
tions. All commands are NORMAL keys. 
No control characters ore used in the 
MINI-MENU, 

WARNING: 

MENU has a problem reading files 
that are in inverse or flashing. MENU will 
print garbage for the file name and will 
generate errors if anything is done to 
that file by the MINI-MENU. MENU will 
only work properly on a normal catalog 
(one that prints only the unmodified cat- 
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alog header and the file names in a 
normal fashion). A catalog that prints 
either the amount of space left or that 
the disk is okay will not be read properly 
by MENU. 

When a CATALOG is done, the file 
names and their status codes are dis- 
played. This is a typical exampie: 

*A009 CALCULATING PI 

And this is an explanation of the vari- 
ous parts of the file status code preced- 
ing the actual file's name 
(CALCULATING PI): 

• - The asterisk means the file is 
locked. If the file wasn't locked this 
would be a space instead of on aster- 
isk. 

A - The "A" tells DOS that the program 
is in Applesoft, "I" means Integer, "B" 
means Binary and "T" means a text file, 

009 - These three numbers represent 
the length of the program or text file in 
sectors. This number will always be 
three digits. 

The status section of the file takes up 
seven characters. The file name takes 
up thirty characters (DOS always 
reserves thirty characters for the file 
name, All characters after the actual 
file name are spaces and printed as 
such). DOS also prints a carriage return 
after It finishes printing the file name, so 
that the following file name is put on the 
next line down. 

The machine language portion of 
MENU fools DOS into putting the file 
name and its status into the string array 
(NAS), insteaa of on the screen. Every- 
thing that is normally printed on the 
screen is put into the array instead, 
including the catalog header. The infor- 
mation can then be used as desired. 

hardcore~computingTo 



Lineo How To Enter MENU 



MENU consists of two parts: 

1 , A machine language fisting. 

2, A BASIC listing 

The machine language routine must 
be entered from the monitor [*) before 
the BASIC listing Is typed. 

First of all, make sure that the Apple- 
soft pointers are set correctly by typing: 

FP Return 

Then enter the monitor by typing: 
CALL -151 

Now type the following lines: 

*m; M 58 08 H U B2 A9 28 Return 

838: SO 53 AA A9 08 80 54 ftfl Return 

811: A9 36 80 55 AA A9 28 SO Return 

9 1 8; 56 AA M 38 81 1,9 80 2C Return 

823: 38 C8 81 68 80 2D 38 60 Return 

329: 38 £9 M 80 FF FF EE 2C Return 

VA\ iS m 03 E£ 20 08 40 W Return 
838: m m Return 

While still in the monitor, set the "End 
Of Program" counter to point to loca- 
tion S83A by typing: 

AF: 3A 08 Return 

Get back into Applesoft by typing: 
3MG Return 

And then type: 
LIST Return 

There should be a line that looks 
EXACTLY like: 

# REM SPEED= I PLOT S LET SPEED* 
PLOT T LET SPEED 6 6 PLOT U LET 
SPEED* PLOT V LET COLOR* RETURN 
+ PLOT f RETURN + PLOT 8 RIGHT* 
END PLOT REM INPUT OUT OF DATA 
= OUT OF DATA 

Do NOT use a printer to LIST line in 
order to compare it. The printer will 



probably LIST it quite differently from 
what appears on the screen. 

If line does not look like this, then 
there is an ERROR in the machine lan- 
guage subroutine and it must be re- 
entered (corrected), 

If unfamiliar with the Monitor com- 
mands, the easiest way to make 
changes is to retype whatever fine Is In 
error. First, get back into the Monitor by 
typing: 

CALL -151 

The Monitor's asterisk ( * ) wilt be 
seen. Now type: 

8013.838 

The figures on the screen are what is 
called a HEX DUMP Compare It with the 
one shown in Figure 1 (the word "return" 
won't be seen after each line). If any line 
is not the same, re-enter the entire line 
followed, again, by RETURN. After the 
corrections are completed, exit to 
Applesoft by typing: 

3D0G Return 

(or, for those with the Autostart ROM, 
just press RESET.) Now type: 

LIST Return 

Again, compare the odd listing of line 
to see if it is correct. 

Line should be the only line of the 
program at this time. The machine lan- 
guage subroutine is hidden behind the 
REM statement and will not be affected 
by RENUMBER or line changes as long 
as this is the FIRST line in the program. 

All that is left is to type the BASIC listing 
as shown, and SAVE It to the disk. There 
is no need to type the other REMs In the 
BASIC listing, but it may help when mod- 
ifying the program later. 

CAUTION 
Do NOT under any condition delete 
or modify Une 0. Any modification to 
line will cause MENU to run incorrectly. 



COMMANDS FOR MENU 



(Ctrl M or} RETURN = 
(Ctrl C) = 

(Ctrl H or) Left Arrow = 

(ctri U or) Right Arrow = 

A through Z = 

(ctrtX) = 



Read a new catalog into memory. 

CATALOG command. Doesn't 
update the catalog in memory. 

Page backward thru the menu. Sup- 
ports wrap around. 

Page forward thru the menu. Sup- 
ports wrap around. 

Used to make single-key selections. It 
will enter the MINI-MENU. 
Ewt the program. 



ESC = "Help Mode". Displays the commands in an abbreviated form. 



r 



MOTE: This listing has been edited to 
■ike it easier to read and enter, To 
do this, I have iade soae changes, 
when entering the BASIC version, re- 
teaber that spaces are only important 
within a PRINT itateient. This 
listing also does not use seiicotons 
when they are not necessary, 

Soaetiies to avoid confusion, the 

PRINT statement Mill look like this: 

1 PRINT 
' SUPERCAL IFRAG IL I ST I CEXP I AL I DOC I 0US" 

Or when it contains normally spaced 
words, it will look like this: 

tm PRINT 'THIS PRINT STATEREHT IS 
DIVIDED BETNEEN WORDS, SO JUST 
PUT A N0RKAL SPACE BETHEEN THEN 
IN ORDER TO RECONSTRUCT THE 
STATEMENT. 

Finally, please include the copyright 
notice so that the original author ii 
given proper credit for the work 
done. <BRH> 



mmt menu listins tmttmmtmm 

— see text — 

1 REN HENU II COPYRIGHT 1982 
BY HARDCORE COHPUTINS 

2 REfl WRITTEN BY R8B8 CANFIELD 
S TEXT : HONE 

>»»» INITALIZE STRINS STflflABE «««< 

1* DIN NA*(104f 

20 FOR X = 1 TO 40: HE* = HE* + ■■■; 

KIT I 
3* FOR X = 114 TO 1 STEP - ii Mf(X) = 

LEFT* (HE*. 38): NEXT 

32 STI = PEEK 1984) 

33 FOR X = 2058 TO 2*73 STEP Si POKE 
X, STI; NEXT 

40 kUii =» LEFT* (HE*, I?) 
51 Dt » CHR* (4): 6* > OR* (7> + 
CHR* (7) 

>»»»» RE-READ CATALOG «(««««« 
-> HARD ENTRY POItfT <- 

55 TEXT : HONE 

hi VTAB 12: HTAB 12: PRINT 'READING 
CATALOG "i VTAB 12: HTAB 29 

»>»» CALL KOINE SUBROUTINE ((««« 
AND GET A CATAL68 

190 0NE8R GOTO 1358 

m CALL 2154: PRINT B* 'CATALOG" 

»»»»» GET HAXINUH PAGE «««««« 

2*6 FOR X = 1 TO 3: IF NIB* (NM (X f 
24 + I), 2, 1) * "■" THEN 211 
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246 NEXT 
210 KB « I - 

Dt "PRI0" 

220 X » I 



l: POKE 216, 0! PRINT 
; PRINT Dt "INI0": PRINT 



How MENU works: A 



>»»»» PRINT FILENAMES <«««««« 
-> SOFT ENTRY POINT <- 

231 HONE 

240 VTAB i: HTAB 10: PRINT HID* (NAt 

(I), 3, 13) 
250 VTAB 3: PRINT HE*! VTAB 19: PRINT 

HEI 
271 IF X < THEN X = HA 
280 IF II > (HA) THEN K « 
tit POKE 34, 4: POKE 35. 18 
300 VTAB 5! HTAB l: PRINT 
310 HONE 

»»»»» PRINT FILENAMES ON ««««« 
LEFT SIDE OF SCREEN 

328 FOR Y - 1 TO 13 

322 At - HID! (NAt (26 * X ♦ Y), 8. 17) 

325 IF HID* (At, 2, 1) - ■■" THEN V « 

V - l: GOTO 440 

330 A* « CHR* (6* + Y) ♦ " " + A* 

350 PRINT A* 

360 NEXT 

370 VTAB 5 

»»»»» PRINT FILENAMES ON ««««« 
RI6HT SIDE OF SCREEN 

380 FOR V - 1 TO 13 

382 At • HID* (NA* (26 » X + Y + 13), 

8. 17) 
385 IF HID* (A*. 2, 1) « "■' THEN HA 

= X: Y » Y + 12: 6OT0 440 
390 A* = CHR* (65 + Y + 12) + " " + A* 
410 HTAB 21: PRINT A* 
420 NEXT 

>»»» CHECK FDR LE8AL SELECTION «<(« 
430 Y P 26 

)» PRINT PA6E I, GET FILE SELECTION <« 

440 POKE 34, 20: POKE 35. 24 

450 VTAB 22: HTAB 30: PRINT "PAGE " 

X + 1 ' OF " NA ♦ II 
460 VTAB 24; HTAB 10: INVERSE ! PRINT 

"PRESS 'ESC FOR HELP";: NORMAL 
470 VTAB 21! HTAB 1: PRINT 

"SELECT ONE (PRESS ft KEY > ";: SET 

At; PRINT 
475 IF At = CHRt (8) AND MA < > THEN 

X ■ X - f: 80TO 270 
480 IF At * CHRt (21) AND MA < > THEN 

X ■ X + t: GOTO 270 
490 IF At = CHRt (24) THEN 1330 
500 IF At = CHRt (27) THEN 3010 
510 IF At ■ CHRt (13) THEN 55 
520 IF At ■ CHR* (3) THEN TEXT : HOME I 

PRINT Dt'CATALOG": GET Bt: PRINT ! 

PRINT ! HTAB 8: PRINT 

"HIT ANY KEY TO CONTINUE ";: 6ET 

Bt: GOTO 230 
530 IF At > CHR* <Y ♦ 64) THEN 470 
540 IF At < "A 1 OR At > "2" THEN 470 
550 A = ASC (At) - 64 

>»» INITALIZE MINI -MENU DEFAULTS ««< 
AND PRINT OUT CHOICES 

560 TEXT : HOME : VTAB 2: HTAB 16: 
PRINT "MINI-MENU" 



This is a line-by-line description of 
Menu. The subtitles are the same as the 
ones used in the listing itself, Line num- 
bers precede their explanations. 

- LINE 0: MACHINE LANGUAGE 

PROGRAM - 
The machine language part of Menu 
is hidden within a REM statement on line 
0. Line E is typed with the machine sub- 
routine (see "How to enter MENU"). 

- INITIALIZE STRING STORAGE (18-50) - 
10: First, reserve memory for 104 file 

names and the catalog header (NAS), 
22): Each element of NAS must be set 
to 38 characters, This is done by creat- 
ing a string [HES) consisting of 40 ,J; =1§ 
and running through a loop that sets 
each element of NAS to the first thirty- 
eight characters of HES [using LEFTS), 
except for NAS[0) which is the catalog 
header and, as such, only needs nine- 
teen characters. 

30: The loop runs backward so that 
theNAS(0) is the first element filled when 
a CATALOG is done. 



32-33: Get the amount of memory 
available in the machine (48K or 32K) 
by checking location 984 (dec). This 
value is then POKEd into the machine 
subroutine hidden in line 0, 

40: Set enough room aside for the 
catalog header. 

- REREAD CATALOG (55-220) - 

(HARD ENTRY POINT) 

55-200: CALL the machine subroutine 
and read the catalog into memory. This 
is the HARD re-entry point. Going to this 
line will cause all information about the 
current catalog to be deleted and g 
new one read. 

206-220: Find the last page of the cat- 
alog. This page minus one is stored in 
the variable MA. 

- PRINT FILE NAMES (230-310) - 

(SOFT ENTRY POINT) 
230, 240: Clear window and print the 
catalog header, 
250: Printthe boundary (HES). 
270: Control the wrap-around fea- 
ture. 
320-370: Look for a blank file name 



565 VTAB 7: HTAB 3: At * NAt- it * 26 

t A): PRINT At 
570 L « 0: B « 0: L* » "K) LOCK": Bt * 

"D LOAD"! Bit = m RUN" 
575 IF LEFT* (At.l) = **' THEN L = 1: 

Lt = "ill UNLOCK" 
580 IF KID* (At. 2. 1) « "B" THEN B - 

l: Bt * "D BLQAD": Bit = "Rl BRUN" 
595 IF MID* (At. 2. 1) * "T" THEN B = 

2: Bt = "E) EXEC' 
590 PRINT Ltl PRINT Bt: IF B < > 2 THEN 

PRINT Bit 
595 PRINT H D) DELETE": PRINT 

"0 CHANGE PROGRAM NAME" 
600 PRINT "A) LOCK/UNLOCK ALL" 
611 PRINT "X) EXIT TO CATALOG" 
6)5 ONERR SOTO 1370 
620 Bt = ": FOR Y = 37 TO 8 STEP - l; 

IF fflDt (A*, r, 1) » " ■ THEN NEXT 
630 A* = HID* (At, 8, Y - 7) 
640 PRINT 
650 PRINT "ENTER YOUR CHOICE > *\\ GET 

Bt: PRINT ; PRINT 

»»»»»»» lock file <«<<<<<«<:<:«< 

660 IF Bt < > "K" OR L < > THEN 710: 
REN LOCK FILE ONLY IF UNLOCKED NOW 

670 PRINT "LOCK -ft*;: SOSUB 3000 

680 IF Bt < > "Y* THEN 560 

690 HOME : VTAB 12 

692 ¥ - » - LEN (At) - LEN (Bt) - 8: 
IF Y ( 2 THEN Y = 2 

694 HTAB (Y / 2) 

699 PRINT "LOCKING "At: PRINT Dt "LOCK" 
At 

700 NAt(X * 26 # A) * "*" + RISHTt 
(NAt (X * 26 + A), 37): GOTO 230 
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»»>»»»» UNLOCK FILE <«««««« 

710 IF Bt < > "U" OR L { > 1 THEN 760: 

REM UNLOCK FILE ONLY IF NOW LOCKED 
720 PRINT "UNLOCK "A*;: SOSUB 3000 
730 IF Bt < > "Y" THEN 560 
740 HONE : VTAB 12: Y - 40 - LEN (At) 

- 11: IF Y < 2 THEN Y = 2 
745 HTAB Y / 2: PRINT "UNLOCKING " At: 

PRINT Dt "UNLOCK" A* 
750 NA* (X * 26 + A) = " " * RIGHT* 

(NAt (X * 26 * A), 37): SOTO 230 
760 IF B * 2 THEN 940 

»)»»>»» RUN/BRUN FILE <«<<«<<«<< 

765 IF B* < ) "R" THEN 900 

770 L* = "": B* = "": Ct = "BfiON" 

B00 IF B ' THEN Ct E "RUN": SOTO B30 

>»>»»» IF FILE IS BINARY. <<<<<<<<« 
GET OPTIONAL LOAD ADDRESS 

810 PRINT I PRINT "HHERE TO "Ct;: INPUT 

" (DEC *HEX ) > "! Lt: PRINT 
820 IF Lt < > "" THEN Bt = " AT " 
830 PRINT C*" " A* Bt Lit! Et = Bt: 

60SUB 3000: Tt « Et: Et = B*: 

Bt = Tt 
840 IF Et < > "Y" THEN 560 
845 ONERR GOTO 1370 
850 PRINT : HONE : VTAB 12 
B52 Y M0 - LEN (At) - LEN (Ct) - LEN 

(Lt) - LEN (Bt) - 5 
854 IF Y < 2 THEN Y = 2 
856 HTAB (Y / 2) 
860 PRINT Ct "INS " At Bt Lt 
870 IF Lt < > '" THENLt » ", A" t Lt 
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line-byline explanation 



[all "=$% If it is blank, then get a file 
selection. Otherwise continue printing 
file names until both columns are filled, 

Line 230 is also known as the SOFT 
entry point. 

- GET FILE SELECTION (448-558) - 

440-460; Set text window and print 
page number and other info, 

470: Get a file selection and check if 
user wishes to: 

475, 480: Page thru the catalog. 

500: Need help. 

510; Exit the menu. 

520: Read another catalog. 

If a file selection was entered, make 
sure that the file exists. 

530: If It doesn't, ignore this selection 
and get another. 

550: Otherwise, go to the Mini-Menu. 
-THE MINI-MENU - 

The MINI-MENU is divided into 12 main 
routines, 

1. Initialize Defaults 

2. Center Printing 

3. UNLOCK File 

4. LOCK File 

5. RUN/BRUN File 



m mm Dt ct At l$ 

890 SOTO 230 

»»>» LOAD/BLOAD SELECTED FILE <««« 

900 IF Bt < > "L" THEN 940 

913 B* = •*■', L* = •■: CI - "BLOAD" 

920 IF B O 1 THEN C* = "LOAD": GOTO 

820 
930 GOTO B10 

>»»»»»» DELETE FILE <«(««««« 

948 IF Bt < > "D" THEN 990 
950 IF [ ■ 1 THEN PRINT Gt 

"THIS FILE IS LOCKED" 
960 PRINT : PRINT "DELETE " Atj: GDSUB 

3000 
965 IF B* ( ) T THEN 560 
970 PRINT : HOME : VTAB 12 
972 y ■ 40 - LEN (Alt - 9 
974 IF Y < 2 THEN Y * 2 
976 HTAB (Y / 2) 

979 PRINT "DELETING " At: PRINT 

D* "UNLOCITAt: PRINT Dt "DELETE" At 

980 RUN 

»»»>»»» RENAME FILE <«<<<<<<(«<< 

990 IF 8* < > "C" THEN 1160 

1000 ONERR GOTO 1310 

1010 IF L » 1 THEN PRINT 61 

"THIS FILE IS LOCKED 

1020 PRINT 

1030 PRINT "RENAME " A*;: GOSUB 3000 

1040 PRINT 

1050 IF Bt < > "Y" THEN 560 

1060 PRINT 



6. DOS Control 

7. LOAD/BLOADFile 

8. DELETE File 

9. RENAME File 

10, LOCK/UNLOCK All 

11, Exit Mini-Menu 

12, EXEC Text File 

NOTE: The word "FLAG" is used to 
denote a variable whose value will 
cause certain actions to be taken. The 
flags are: 

B is the "Binary/ Text" flag, 

B = Applesoft or Integer file. 

B = 1 Binary file. 

B = 2 Text file. 

L is the "Lock/Unlock" flag. 

L = Unlocked, 

L = 1 Locked. 

1) INITIALIZE DEFAULTS (560-650) 

560,565: Print "MINI-MENU 1 , then set 
AS equal to the proper file name and 
print it, 

570: Set default options (LOCK, LOAD 
RUN), 

continued on page 70 



1070 PRINT "CHANGE *. 

PRINT "TDM NORMAL ! PRINT ' ";: 

INPUT Bt 
1075 IF LEN (Bt) > 30 THEN HOKE j VTAB 

12: GOTO 1320 
im IF Bt = ■* THEN 540 
1090 HONE ! VTAB 12 
1092 Y - 40 - LEN (At) - LEN (Bt) - 12 
1094 IF Y > 38 OR Y < 3 THEN Y = 2 
1096 HTAB <Y / 2) 
1100 PRINT "CHANGING ' At " "f: INVERSE 

: PRINT "T0"f: NORIfAL ! PRINT " " 

Bt; PRINT Dt "UNLDCK" At: PRINT Dt 

"RENAME" At V Bt 
1110 IF L « 1 THEN PRINT Dt "LOCK" Bt 
1115 NAt (X * 26 + A) = LEFT* (NAt 

IK * 26 t A), 7) + Bt 
1120 GOTO 230 

»»»» UNLOCK/LOCK ALL FILES «««<« 

1160 IF Bt < > "A" THEN 1280 

1170 PRINT ; PRINT "LOCK/UNLOCK ALL 

FILES ";: INVERSE ! PRINT "L/U"f! 

NORMAL : GET Bt 
1180 IF Bt < > V AND Bt < > "0" 

THEN 560 
1190 IF Bt = "If THEN Bt * "UNLOCK": 

Tt = " " 
1200 IF Bt = V THEN Bt = "LOCK"! 

Tt = ■#• 
1210 PRINT : HONE ! VTAB 11: HTAB 

(40 - LEN (Bt) - 6) / 2: PRINT Bt 

"INS ALL" 
1220 FOR Y = 1 TO 105 
1230 IF HIM (NAt m, 8, 2) = ■«■■ 

THEN 230 



1240 VTAB 13: HTAB 10: PRINT NIDt (NAt 

(Y) 8 30) 
1250 PRiNT'Dt Bt HIDt (NAt (Y), B, 301 
1252 NAt (Y) = Tt t RIGHTt (NAt(Y), 37) 
1260 NEXT 
1270 GOTO 230 

»»»»»» EXIT MNI-flEMJ? <««««« 

1280 IF Bt - "X" OR Bt » CHRt (27) OR 
Bt " CHRt (13) OR Bt > CHRt (24) 
THEN 230 

»»»»»» EXEC TEXT FILE «««««« 

1282 IF B < > 2 OR Bt ( > "E" THEN 

560 
12B4 Ct = "EXEC": Lt = '": Bt = ": 

SOTO 830 

1300 TEXT : HOME : END 

>»»»»» ERR ROUTINES <««««««« 

1310 IF L = 1 THEN PRINT Dt "LOCK" At 
1320 PRINT : PRINT St 

" ERR IN NEK NAME. PLEASE TRY 

AGAIN" 
1330 ONERR GOTO 1350 
1340 PRINT I HTAB 7: PRINT 

"PRESS ANY KEY TO CONTINUE' j: SET 

Bt: GOTO 560 
1350 POKE 216, 0: PRINT Dt ■PMI'i 

PRINT Dt MN00': PRINT 
1360 HOME : VTA8 12: HTAB 3: PRINT Gt 

'!!! - UNABLE TO READ 

DIRECTORY !!!': POKE 216. 0; END 
1370 HOME : VTAB 12: IF LEFT* (Lt. 3) 

* " t At" THEN HTAB 10; PRINT Gt 

"ERR IN LOAD ADDRESS': GOTO 1340 
1380 PRINT Gt "STRANSE ERR. I KILL 

RE-READ THE CATALOG': PRINT : HTAB 

6: PRINT "PRESS ANY KEY TO 

CONTINUE'): SET Bt: GOTO 55 

»»» SUBROUTINE TO GET KEYPRESS ««« 

3000 PRINT ' "i: INVERSE : PRINT 
"Y/N'C NORMAL : SET Bt; PRINT : 
RETURN 

»»»»» PRINT INSTRUCTIONS ««««« 

3010 TEXT S HOME : VTAB 2: HTAB 14: 

PRINT 'CDNMANDS": PRINT : PRINT 

HE*: PRINT 
3020 PRINT "> RISHT ARROtf MOVE FORWARD 

THRU MENU": PRINT 
3030 PRINT H LEFT ARRQN MOVE BACKWARD 

THRU NENU": PRINT 
3040 INVERSE : PRINT 'N't! NORMAL : 

PRINT " 'RETURN' SET'S A KEN 

CATALOG": PRINT 
3050 INVERSE : PRINT "C'f! NORMAL : 

PRINT ' CTRL »C SET A NORMAL 

CATALOG": PRINT 
3060 INVERSE : PRINT "X'j: NORMAL \ 

PRINT " CTRL 'X' EXIT MENU': 

PRINT 
3070 PRINT " ANY LETTER fM GO'S TO 

HINI-HENU": PRINT 
3030 VTAB 20: HTAB 7: PRINT "PRESS ANY 

KEY TO CONTINUE')! GET Bt: PRINT : 

GOTO 230 
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Sof tkey 3= 
Controlling the 
I.O.B. 

Softkey III will deal with disks that 
change the address and data marks 
from track to track, or use the standard 
DOS marks but change the sector num- 
bers. None of the "MUFFIN'S" will work 
on these disks. They reauire a special 
program to directly access the disk. 

This program accomplishes the task 
by doing a "brute force', sector-by- 
sector copy of each track , On a 1 3 sec- 
tor disk, it will cause the disk drive to 
recalibrate (the racheting sound) on 
any sector that doesn't contain data, 
This is nothing to worry about and does 
not mean the program Is not working. 

The program calls the RWTS (Read or 
Write a Track/Sector) directly and uses 
its own IOB (Input/Output Block). The 
procedure for This is very well doc- 
mented in the DOS manual (page 94- 
98). 

Basically, the IOB is a list of parameters 
that is used by the RWTS whenever a 
disk access is necessary. This list 
Includes the Slot, Drive, Track, Sector 
and Volume number. Each call to the 
RWTS will, depending on the Command 
code, position the Read/Write head 
only, Read or Write a single sector, or lNI- 
Tlallze the disk. 



Otsksf 



by Bobby 




SETTING UP THE CONTROLLER 

The controller is the heart ot the IOB 
program, It starts at line 1000 and 
defines the Track/Sector pairs that you 
wish to copy and the address and data 
mark values you will use to read or write 
them. 

Two basic controllers are listed. The 
first assumes that only the sector num- 
bers are changed. The second 
assumes that only the address and 
data marks are changed, They are pre- 
sented as samples of what you can do 
with the program. The controller can be 
as simple or as complex as necessary. 



i 



Controller #1 

This controller is set up to copy a disk 
that uses standard address and data 
marks, but changes the sector numbers 
so that they step by even increments. 

NOTE: Use the 4+4 Conversion Chart 
in Dlsklocks (Issue 2) to convert the 
encoded sector bytes for each address 
mark to hex. Verify that the sector num- 
bers step by even number increments 
(ie. 0,2.4,6,8, 10 etc.) 



1000 FOR TK = 3 TO 34 




1010 DV « 1 ! CD > fit} 


GQSUB 50 


GQSUB 35 




1020 dv * 2 : CD ■ m ; 


SOSUB 50 


GDSUB 80 




1830 NEXT 





s«aeco«»gm»«»s »rCT ? wg » a g fl r re??w'TO 3**3ga 



Controller #2 

This controller is set up to copy a disk 
that uses different address and data 
marks on each track. It assumes that all 
six bytes (3 address/3 data) are 
changed, if only one or two are 
changed, the controller can be altered 
to show this, (IE. If address mark A2 Is 
unchanged then the 'READ A2' could 
be omitted from line 60 and the 'POKE 
47455,A2' omitted from line 70.) 

Both controllers set up a FOR/NEXT 
loop for the track numbers and GOSUBs 
to the appropriate routine to READ/ 
WRITE a track. 



Often the checksum on the original 
disk Hill be altered. If vou think this 
is the case then add line 200 to the IOB 
prograa. 

200 SOSUB 55 



This change Hill cause DOS to look at 
the start of address and start of data 
■arks and ignore the checitsut and end 
•arks. 



1000 FOR 
1010 DV = 

40 : 
!020 DV « 

90 ' 
1030 NEXT 



= 3 TO 34 
i ; CD = RD 
SOSUB 80 
2 : CD = WR 
GQSUB B0 



SOSUB 50 : SOSUB 
60SUB 50 : GDSUB 



Nhen typing the data for line 63050, 
be sure to Maintain the proper order. 
The routine that READs the data assuses 
that the address aark information is 
first and the data aark information is 
second, 



How To Use the 

Requirements: 

Apple II or Apple 11+ with 48K and 
Applesoft In ROM 

13 sector or 16 sector DOS (as appro- 
priate) 

Blank disk 

108 program 

DiskView or other nibbler 

Perform the following steps: 

1 . RUN DiskView 

2. Remove the DiskView disk and 
insert the back-up copy of your pro- 
gram disk. 

NEVER USE THE ORIGINAL DISK 

3. READ track3and look for the start of 
address and the start of data marks. 
The normal values are D5 AA 96 
(address) and D5 AA AD (data). Write 



I.D.E. Pro 



10 



» set LOrffll above buffer « 
TEXT : HONE I LONE* : 16385 : GOSUB 
63000 ! SOTO 100 
» print track and sector info « 
20 HOtlE ! VTAB 12 i HTtt 12 ! PRINT 
■TRACK 'TK' SECTOR 'ST ! RETURN 
» center text on screen and print « 
30 HTflB 20 - ( LEN (M) / 21 : PRINT A* 
i: RETURN 
» wait for key press then return « 
40 HONE ; VTAB 12 : SOSUB 30 : VTAB 14 
; At = "PRESS ANY KEY TO CONTINUE " 
; SOSUB 30 : 6ET AW : RETURN 

» poke viriablri into IOB << 

50 POKE BUP.32 : POKE Cr1D,CD : POKE 
TRK.TK : POKE SCT.ST ! POKE DRV,DV ! 

POKE V0L,VL I RETURN 
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Softkey4 : Boot Code Tracing 



I.D.B. Program 

down the values that you find. 

NOTE: See Disklocks (issue 2) for more 
information on address and data 
marks. Practice on a normal DOS disk 
until you are familiar with the disk format 
and can easily find the address and 
data marks, 4. Repeat step 3 for each 
track (3 to 34). 

5. Use the Byte Cross-reference Chart 
to convert the hex bytes to decimal. 

6. Load the IOB program. 

7. Make the appropriate changes in 
the controller (lines 1000 thru 2000) 
Insert the decimal values from step 5 
into the data statements) at line 63050. 

8. Run the program. 



gram Listing 

» gtt address and data «rk» « 

40 READ Al I READ A2 : READ A3 : 
READ 01 : READ 02 ! READ D3 

» poke the info into DOS « 
7# POKE 47445.A1 ! POKE 47455,A2 : 
POKE 47446, A3 : POKE 47333, M : 
POKE 47345,02 : POKE 47354,03 ! 
RETURN 

» read/Hrlte i trick « 
30 FOR ST - I TO D08 ! POKE SCT.ST : 
60SU8 28 ! CALL 10 i POKE BUF, PEEK 
(BUF) M : NEXT : RETURN 

» read ■ track by even no. sectors « 

85 FOR ST « i TO OOS ♦ 2 STEP 2 i POKE 
SCT.ST : 60S0B 28 : CALL 10 : POKE 
Wt PEEK (BUF) + I : NEXT I RETURN 

continued on page 53 
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Requirements: 
A copy of Apple Galaxlan 
48K slave Disk (with the hello program 
deleted) 

Knowledge of machine code/ 
assembly language 

Boot code tracing is the most difficult 
of all the SoftKeys presented. It is also 
the most effective method of transfer- 
ring single load binary programs, which 
are programs which load into the 
Apple at Boot and do not access the 
disk again. 

This SoftKey is definitely not for begin- 
ners, You must have some knowledge of 
machine code or assembly language. 

The initial Boot or Boot is determined 
by a program on the disk controller 
card. This program is stored in ROM 
(Read Only Memory) and cannot be 
changed by the program on a disk, A 
non-standard format may be used on a 
disk to prevent copying, but that disk 
will not Boot on your Apple unless track 
0, sector is readable by the disk con- 
troller card. 

This means that you can also read it, 
and by controlling the boot process you 
can determine where the program is 
and save it to disk. 

In order to demonstrate this process, 
the Boot of the binary program Apple 
Galaxian will be traced. This is a familiar 
game and almost everyone owns a 
copy. 

The Boot code is at SC600. If your 
controller card is not in slot 6, then 
change the number after the SOC to 
correspond to the appropriate slot (IE. 
Slot 5 would be SC500). First the code 
will be moved down into RAM (Random 
Access Memory) where a portion of it 
can be modified. Turn on your Apple, 
then enter the monitor (CALL 151) and 
type: 

9600 < C600.C6FFM 

This will move the Boot code to page 
S96 ($9600), where the changes will be 
made. 

NOTE: Commands will be on a sepa- 
rate line and printed exactly as you 
should enter them. Press return after 
each line entry, II a command has 
already been listed, it will be referred 
to but not listed again. 

Be sure you move the code to a page 
boundary that corresponds to the slot 
that your controller card is in (IE. for slot 6 
- $9600, $8600. $7600 etc. or for slot 5 - 
$9500, $8500 etc.). The reason for this is 
that the Boot code contains a routine 
that finds which slot the controller card 
is in. It does this by calling a return code 
in the F8 ROM and extracting the return 



address to locate the page boundary. 
The code itself is relocatable (will run 
anywhere in memory). 

The purpose of Boot is to transfer the 
code stored on disk at track 0, sector 
into memory and to execute it, Then the 
disk code [Boot 1 ) will take over the Boot 
process. Here is where the first change 
will be made. 

Examine the code at the end of page 
$96. At S96F8 you will find a JMP to $801 . 
This is the next Boot stage [Boot 1 ), Boot 
needs to load and not run the Boot 1 
code at page $08, so the code at 
S96F8 will be changed to JMP to the 
monitor after turning off the drive motor, 
In order to save having to reenter the 
same code, put the routine at $9500. 

96FA:95 N 9504 :AD E8 CO 4C 59 FF 

The base address SC088 is used to 
turn the drive motor off. You must add 
the slot number of your controller card 
to this address in the form $S0 where "I" 
is the slot (IE. slot 5 would be $C088 + 
$50 = SC0D8). For those of you not 
familiar with hexadecimal numbers, 
there is a table on page 82 of the Apple 
II reference manual with the base 
addresses and conversions for each 
slot. 

After making the changes and 
checking that they are correct, you are 
ready to begin. Run the code at $9600 
(Boot 0). 

S9680G 

When the drive stops, Boot 1 will be in 
memory at page $08. If you examine 
the code at $800 you will see that it is 
written to run at page $02. The first part 
of the code is a move routine that trans- 
fers the code from page $08 to page 
$02, then JMPsto page $02. 

Boot 1 should be moved to page $98 
so you can make changes. The code 
must be moved or else the next time you 
run Boot© it will be overwritten, 

9800< 800.8FFM 

Now the modified Boot can be 
linked at $9600 to the Boot 1 code at 
$9800. The move routine should then be 
changed so It will work at its new 
address, and the JMP to the next Boot 
stage should be changed to the routine 
at $9500. 

96FA:98 N 9805:96 N 9843:95 

The "N" is used as a null command to 
separate changes. It is the monitor 
command to set normal mode and 
does nothing, since you are already in 
normal mode. 

After you have made the changes 
and checked that they are correct, run 
the code at $9600 again. 

continued on page 53 
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Apple Softies are programs presented in a way that will reveal certain aspects of Applesoft BASIC. These programs are not only valuable in 
themselves (whether they are instructive, business or entertainment software) but are also valuable as examples of how to utilize Applesoft in your 
own programs. By typing in these programs and then altering lines to fit your own needs and esthetics, you will refine your own knowledge of 
Applesoft. More importantly, we hope that you will make creative improvements. If you do, please send them in to us so that other readers may 
enjoy and learn from them. 

NOTE: When entering AppleSoflies, remember that only the first two characters of a variable name are important. You may wish to shorten some 
of the long variable names. If so, please do not remove the variable suffix (%, S, or array notation), Use the editing features of Applesoft as well as 
some of its input shortcuts (such as using "?" for "PRINT", and ignoring spaces except in PRINT, DATA, or REM statements. 

A Hi-Res "Shoot The Invaders" Game 



Zyphyr Wars 2.0 is an Applesoft hi-res 
'shoot the invaders' type of arcade 
game (which abound in Apple-dom). 
This particular one is not only a com- 
plete game in itself, but is also a 'core' 
program that you are encouraged to 
alter and adapt so that you get a 'feel' 
for the ease with which such games are 
created. (It is an egotistical myth that 
the writing of computer games is a diffi- 
cult or a special art!) 

special features 

This program is a fast single-player 
game with some interesting features 
worthy of publication in apple-softie. 
Instead of using a hi-res text/character 
generator (but easily adapted to use 
one, by the way), this version flashes the 
'hit points' by switching screens [text 
and hi-res) in rapid, repetitive bursts that 
give the illusion of text on the hi-res 
page, Also, the UFOs or Zyphyrs (hence- 
forth called 7s") appear to 'zip' across 
the screen, much faster than is really 
possible, And you have an entire city- 
scape to protect rather than simple 
bunkers to hide behind. Plus, this game 
uses SHAPE TABLES. 

A city is built on the Pottom and your 
ship, a satellite, isDRAWnatthetop.Ten 
Zs appear between your ship and the 
city skyline below and you must destroy 
them before they destroy you and your 
city. If they succeed in creating deep 
craters, the game will end. These Zs zap 
your city and your ship with death rays, 
while you must zap back using your own 
ray. But because you will be shooting 
down at them, a miss will destroy parts 
of your own city. If you miss too many 
times, the game ends dramatically, 

When you destroy the first ten Zs, you 
are elevated to the next level and 
another ten will appear. Each higher 
level that you achieve will subject your 
ship to more frequent attacks. And if 



your ship is hit, it plummets to the 
ground, destroying the building 
beneath it. You have only a few ships. 

This Apple-softie will show you that 
arcade-type games can be written in 
Applesoft, too. However, I do use sev- 
eral 'tricks' that allow it to play quickly. 

1. illusions of speed 

First of all, I don't really 'move' the Zs 
around 'bit by bit.' Instead, I give the illu- 
sion of fast movement by connecting 
their old and new positions with a line 
and then adding a 'zip!' sound, hence 
the name 'Zyphyr,' not zipper. (I do, how- 
ever, make your ship move 'bit-by-bif 
whenever it crashes.) 

2. paddles only 

Secondly, when I DO move the ship 
Pack and forth, I do not make it step 
across smoothly. I use absolute paddle 
positions and the ship 'materializes' at 
whatever value the paddle happens to 
be turned to when its value is checked 
by the program. That means that the 
player can also make the ship 'zip' from 
one side to the other, a necessary fea- 
ture if the player wishes to zap the Zs. 

3. rays, not bombs 

Thirdly, I don't move 'missiles' or 
'bombs' because that slows everything 
down (remember Text Invaders?). I 
HPLOTor XDRAW lines (rays) instead, giv- 
ing the appearance of an immediate 
'hit' or 'miss.' 

4. hit or miss? 

And fourth, I don't make the program 
go through long searches Just to deter- 
mine if a ray has hit or missed, The pro- 
gram only permits the Zs to appear 
directly over the center of each column 
of Puildings, and then only one Z per 
building, The player's ship moves 
across in a similar fashion, appearing 



only over the center of each building. 
Therefore, the only search that is neces- 
sary is to simply determine if the column 
in which the ship presently resides is 
also occupied by a Z! 

a shape table 

The buildings consist of 'shapes' 
stacked up in columns. The Zs are also 
conglomerate shapes (allowing the 
programmer to change their shapes). 
But the player's ship is a single 'shape.' 

The shapes are poked into memory 
page 3 (S31B0 hex, or 768 in decimal) 
along with a short sound' routine, DRAW 
and XDRAW are used extensively, along 
with HPLOTs in order to give the readers 
examples of various hi-res graphic pos- 
sibilities. The reader may wish to turn all 
HPLOTs into XDRAWS. 

sound effects 

There are a variety of noises used in 
this game, including a soft 'zip' sound. 
Should you have a favorite sound rou- 
tine, you might want to use it instead. 

This is how the program works; 

the program 

First off, the 40 columns (representing 
the 40 character-column text format) 
must be reserved by DIMensioning 
them at the very start, 

COL%(40) , . . This integer variable 
array will store which Z is above which 
building (column). If empty, it will be 
equal to zero. 

HEIGHT(40) , , . This array will store the 
height of the building. When struck by a 
ray or a falling ship, the Puilding will 
diminish in height until a crater is dug 
into the ground. 

XUFO%(10), YUFO%(10) . . . These 
arrays store the X and Y positions of all 
ten Zs. 
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Eyphyr 

Ware 
S.D 

[HI Ban S. VeUffU 




<5> 



-1000 
> ZYPHYR WARS < 



£1) 



Also, 1o keep track of the player's 
lip, there are: 

PN%, or the New Paddle position, and 
PO%, or the Old Paddle position. 

Ti-res text trickery 

After the variables are defined, the 
jame itself is sel up in lines 12000 
hrough 12090, It HPLOTS the earth 
HARTH=152] on hi-res page 1 (13000- 
3030], Then, on text page 1 (13100- 
13130], it sets the bottom of the text 
dndowto 19(13180), (That means thai 
he 4 rows seen below the hi-res screen 
n the mixed-mode are actually outside 
}f the window. This will pose a small 
Droblem later when we try to print 
Delow the window,) The ground is con- 
tinued into the text page, This gives the 
illusion of having text on the hi-res page. 
This is an effect we will later enhance. 

the city shapes up 

Next, the buildings are calculated 
and XDRAWn (14000-14090}. Only the 
inner 38 columns are used for buildings 
;14000). A random height is chosen and 
subtracted from EARTH. Why subtrac- 
tion? Well, remember that as the height 
of the building increases, the actual Y 
value gets LOWER, not higher, because 
the Y value at the very top of the screen 
is zero! 

Now, one of the 5 building shapes 
from the shape table is chosen at ran- 
dom (14040). These 5 shapes show a 
window (or windows) at various posi- 
tions (see SHAPES FOR ZYPHYR WARS]. 
When stacked together (14060), 
something resembling a modern build- 
ing is created. Shape # 6 is a plain and 
simple vector dash, but at SCALE 7 it is a 
solid line (14050], This line separates the 
building levels. 

stars in 4 colors 

After the buildings ore up, stars are 



drawn from top to bottom (14100). 
Because stars are just PLOTed points 
(14130), color is inevitable even when 
specifying HCOLOR *3 or HCOLOR=7. 
By alternating between the two types of 
white, all 4 colors are PLOTted, 

The Zs are calculated next. Each will 
appear on a specific row correspond- 
ing to a text page row, I do this for a rea- 
son that you will see later. Only one Z per 
column and per row is permitted 
(15010). COL%(n] is then filled with the 
row number of the Z that occupies it. 

ready to play 



GOSUB 2068 



The game is now ready to play, The 
text displays are PRINTed. This is accom- 
plished in a unique way because it must 
be PRINTed below the text window. Nor- 
mally, if you tried to PRINT a string of 
more than one character outside the 
window, only the first character will be 
printed outside, the rest will appear 
inside. Therefore, a long string must be 
VTABed and HTABed into place one 
character at a time. 

The main game sequence is con- 
trolled in lines 100 to 190, a loop with 
GOSUBs. This allows you to add your 
own routines. For example, you may 
want to make this a two player game 
with a tank or gun moving along the 
bottom that shoots upward at the other 
player's ship or at the Zs. 



GOSUB 1000 



The first GOSUB moves the satellite in 
response to the paddle. I use paddle 1 . 
It DRAWs and reDRAWs the ship. But 
drawing and redrawing anything on a 
single hi-res page will make it flicker, So, 
instead of using two entire hi-res pages 
to remove the flicker effect (which uses 
up too much memory], I remove it by 
allowing it to erase and redraw only 
when the position of the ship must be 
changed [1100], 



The second GOSUB is more complex 
and is composed of its own series of 
GOSUBs. It first moves the Zs, but only 
one of them. I originally moved them 
sequencially from top to bottom, but it 
made the game too predictable, so 
they now move at random. To move 
them, the program must first check if the 
random Z it selected still exists (it could 
have been shot], If it doesn't exist then 
that's the end of that. If the Z is still 
around, the program then generates 
another random number and checks if 
that particular column is empty. If not 
then it runs off to a routine that allows 
the Z to shoot down at the city, But if the 
column is empty, the program checks to 
see if the Z should shoot at your ship. The 
chances of it shooting at you will 
increase as you ascend the various lev- 
els (by wiping out all ten Zs]. 

10 zipping zyphyrs 

Finally, the Z gets to move. It deletes 
itself from its old COL% and places its 
number in the new COL%. It changes Its 
XUFO% value accordingly. Now comes 
the illusion of movement, the 'zip.' A 
FOR-NEXT loop is initiated that goes 
from 3 to 4 because I let it determine the 
HCOLOR (white is 3 and black is 4]. 
Drawing and undrawing the Z is a 
GOSUB inside a GOSUB. And, instead of 
storing a Z 'shape' in the vector table 
(as I did with the ship), I opted for a more 
flexible but slower format (for variety) 
that would permit you to alter the Z 
shape (200-260) more easily without 
changing the shape table itself, 



GOSUB 3006 



The third main GOSUB is conditional 
and depends on whether the paddle 
button is depressed at the time that the 
routine checks it. If not depressed, the 
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program loops back on itself. If 
pressed, it means that the ship is shoot- 
ing, it checks to see if a Z occupies its 
column. If so, then the Z vanishes and 
U% (UFO counter] is raised by one. If 
over 9, a new level has been reached 
and ten new Zs are created. If not, then 
too bad because any building below 
will be completely wiped out and your 
score will be decremented by a thou- 
sand points. And if you accumulate a 



negative 100,000 points then the game 
ends. 

Switching screens 

One of the things you should notice 
whenever you hit a Z is that the hit points 
are flashed in the same place where 
the Z expired, That effect is accom- 
plished by switching screens rapidly 
(9030-9080). In this way one can project 



i»» »g>o gafrfe»g«Si »o ^ oo»»o» < >o ^ p»so oo'0^ ^$^» o» o o iao> oooooo 



EXPLANATIONS OF THE VARIABLES 



Counters _._ 



0thers___ 



|S— 

ft$ usee! to print itessages to 

screen and to GET an answer Irost 
the player, (350,3B0> 

GUN*- rjinber of guns. (350> 

LEVEL* level sailer, <340> 

SCt score number. (9020-9050) 

Permanent Values 

BLtH = -16336 (speaker). '300,310,320, 

613,743,813,823,9043, 10813> 



shape Ufcle, <ll;00,H!13> 



Flags 



mm ts avo:d "OUT OF WW-, 

RjPSX @t 1, to flash text page 

H[— — — 1 or -K to select HCOLDfi. 

5F:;— or 1, tc shoot or rot to 

steal at the satellite, (403, 2433) 



Arrays 



CGLI'4^ what Zyphyr is over each 

■builriinj !coIufin), a rnjabsr from 
iere to" ten. (13.263.2230.2750, 
2i«. 3310-3033, 150lH5050> 

HE16H T V4^)-the heigh; of the 40 





--the lyphyr's v" location, 

f "i 3 t 203, .2jSI,4j$,.350.2?3^ 53-23 - 
»3fc §3f0~M3, 15330) 



V, usually a building top. 

iU Saae a; above, but the X. 

<600-ia0, 913-933) 



ft. M, E, I, R. Rffi, 3, Z 

U?.— Zyphyr counter, if 13 then ADD Points to add to score, 

increment LEVEU. (848, 943-960, 9010-9320) 

(2533-2400) 

SStrmns «WHt Nmeber of satellites, 

UUIllip (353,750, 13003) 

HEIGHT Used to calculate HEI6HU. 

LEVELS Level number, (363,550,843, 

940-940, 2430, 9010.1033) 

HEM —Used to POKE in DM. 

(11110-11150) 

N Noise aaker. (300-320,410, 

813-820,9040) 

PN'/. New value of Paddle. 

(tti, 650-660,713-740, 810-830, 1300- 
1330,3313-3030,9013) 

SI « -1628* (button SI). (120, 10013) POX —Old paddle value. 

EhF:TH * 152, the qajse ground level. (1100-1330) 

(i30,Si3, 320, 330,950,4013, 10003, PTS Points, in a STKirta it is 

mii.mi&i 14033, 14103) called SC*. (9320-10003) 

START - 768 ';HEK-I330), a convenient S3 Sew Zyphyr nmtber, equal to 

place to put the noise routine and RNDU1 t 37 *\, (2100-2903) 



QUANTITY— DATA statement value to 

POKE in to flEM. (11123-11140) 
p-; w (, a i tiui 1 di ng shape to 

KDRftld, a number from 1 to 5. 

mm, 14340) 
STAR H location of random stars. 

(14123-14133) 
11 1 to 38, temporary column 

number to calculate Zyphyrs. 

(15010-15050) 
ttl- -4 location of the satellite 

(410-423,3800) 
TV?. — v location of the satellite 

usually 5. (410-420,3310-3020. 9310) 
UlS — -X location of the center of 

Zyphyr, used to draw ray. (480-470) 
y V y, y latition of Zyphyr. 

(433-673) 
I 1 location of super BOOM! 

'3!20,3!33> 

X location of the left edge 



text on the hi-res page for brief 
moments without using a character [or 
block-graphics) generator, 

This version is small enough to fit com- 
fortably beneath hi-res page 1. How- 
ever, if you add any more routines, or if 
you add more remarks, you should con- 
sider loading it above hi-res page 1 or 
you might just wipe out the tail end of 
your program when you try to RUN it. 
Use a 'loader program' similar to the 
one used with B. Bryte's island Map Edi- 
tor, Also, if you or your club has access 
to one of the Applesoft compilers now 
available, you should try compiling it to 
make it more challenging. 



VECTOR SHAPES 



\ 



5 *>-*^-*>-* 



Applesoft 
LISTing for 
ZYPHYR WARS 



«=«=„ COPYRIGHT CREDITS =»========«= 

1 REK ZYPHYR WARS BY BEV R. MIGHT 

2 REtt COPYRIGHT 1782 BY 

SOFTKEV PUBLISHING 
14404 EAST D STREET, 
TACOKA, HA 93445 

10 TEXT : HOME : HGR ! DIH HEI8HTIHI), 
XUFK(tt), WQHW, COLHW i 60T0 
If" 



««■««« item ntc semncer «»===>« 

130 GQSUS 1080 

110 G0SE1B 2003 

123 3F PEEK (Bl> > 127 THEN SOSUB 3080 

190 GOTO 180 
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DRAW ZrPHVRS »«* 



205 SCALE -~ 1 : DRAW 6 ft! ft t 3, Y* - 

210 SCALE = 5 ! &RAW 6 AT ft* %, 11 - 

220 SCALE = ! : DRAW 5 AT !S. Y* 

225 SCALE a !1 : DRAW i AT X* - 2, f* * 

1 
W SCALE » 13 : CRAW 6 AT K - 3, Y* * 

2 
235 SCALE = 7 : DRAW 6 AT U, Y* + 3 
241 SCALE « 1 : DRAW 5 AT HI, tt * 4 
250 RETURN 
260 HI = XUFO* ( COL* I PN* ,' i I 7: 

M = YUFD* ! COL* < PN* I I : ROT = 

: GOTO 205 




<3; 



wu ' 



-66005 
> ZYPHYR WARS < 



<2> 



30? FOR 5 = i TC 3 : N = PEEK mill [ 

NEST : RETURN 
310 FDR S * i TO II : H = PEEK (WW 

: NEXT : RETURN 
328 N = PEEK (BUZZ) - PEE* WU) ■ 

RETURN 



*£«**3*sese**sa DISPLAY SUNS 



35? HTAB 3 : SUN* ■ "C * 3TR$ (GUNK) + 

4 " : INVERSE t VTAB 21 : FOR A = 

1 TO LEN (6UNt) : PRINT HID* fflMt, 

A, 1! ;: NEXT : NORMAL : RETURN 



660 SCALE = 3 : ROT = 11 : ZH* = | : 

IF PN* = ZH THEN ZH* - 5 
67? FOR AA = 3 TO 4 ; HCOLOR = AA : 

hplqt \in, uyx to ux*, m •. sosub 

320 : NEXT : S05UB 5200 i GOSUB 300 
! IF ZH* t 5 THEN 7?? 

6B0 RETURN 

^^===z=^= SATELLITE FALLS ====«==« 



DISPLAY LEVEL 



360 VTAB 2i : HTAB 35 : LEVEL! > "!" i 
STR* tLEVELV.) + T : • INVERSE ; 
FOR ft = i TD LEU (LEVELS : PRINT 
HID* (LEVEL*, A, i! ;: NEXT : 
NORMAL : SOSUB 538? : RETURN 



DRAW m 



m ROT^ 16 : SCALE= 3 

41? HCOLOR « 3 s FOR A « 3 TO TY* STEP 

TY* / 1? ! DRAW 6 AT TIL A i POKE 
6, A i POKE 7, 3 ; CALL UB : NEXT 

42? HCOLOR * ? : FOR A = 8 TO TY^ STEP 

m i 10 i DRAW 6 AT U% A I NEX T 

440 RETURN 



70? 
71? 
720 

730 
74? 



ROT a ? : SCALE * 1 

HCOLOR * : DRAW 8 AT PNX 1 7. 5 

ROT = 32 : FOR A = ? TO HEIGHT* 

(FN*) STEP 2 

FOR AA * I TO 2 

XDRAW 8 AT ?Mt 7 + 7, A : POKE 

5. A : POKE 7, 6 : CALL 763 : N = 

PEEK (BUZZ? 

NEXT I NEXT ; GUN* = GUNK - 1 i 

GOSUB 58?0 : IF GUN! 1 . = THEN 850 



GROUND EXPLOSION 



60? 
81? 



============= LEV£L COUNTER ■«■«««»« 

550 p % W. ft t II IS'il THEN U* c 
: LEVEL* ■ LEVEL! + 1 i GOSUB 
15000 

560 RETURN 

==== s=ss=ssss 2VPHVR SHOOTS *s«?**?***a 

60? UX* = JIUfOI (Zl I K 3 : UY* * 
YUFO* (Z! : W. * XUFO* (2) : 2H% 
« HEIGHT?. !ZM) : IF SF* > THEN 
SF* = ? ; GOTO 660 

610 FOR AA = 3 TO 4 : HCOLOR = AA ! 

hplot mr. tin to tin, zh* t next s 

GOSUB 100? 

62? GOSUB 90? 

630 im • ZH* + 2 : IF IH7. > EARTH 

THEN GOSUB 95? 
640 HEIGHT): (IE) = IHX : RETURN 

65? tin = mt 7 ♦ 3 : an = i •. m 

= ?M : M = HEIGHT); lift,) l GOTO 
62? 



HCOLOR 
IF HEI 
FOR AA 
SCALE= 
STEP 2 
: ROT 

m * 

PEEK I 
GOSUB 



GHTX m& > = EARTH THEN 
« 1 TO 2 t FOR A = 2 TO 6 : 
3 t A : FDR R = ? TO 20 
; FOR RR = - 1 TO 1 STEP 2 
' 112 - fi t RR t XDRAN 6 AT 
7 + 3, EARTH : NEXT : H = 
BUZZ! : NEXT : NEXT : NEXT : 
35? 



m***s WHOLE BLBG. GONE 



820 



S3? 
840 



FOR AA *■ HEIGHT?. (FN*) TD EARTH 
STEP 2 : HFLOT PN?, t 7 - 1. AA TO 
PNI t 7 t 7, AA j HPLOT M t 7 - 
2, AA - I TO PNX t 7 f 8, AA - 1 : 
N * PEEK (BUZZ) : NEXT 
HEIGHTS (PNI) - EARTH : GOSUB 350 
ADD ■ - 1MI I LEVEL* r GOSUB 9020 
; RETURN 



END OF GAME *n 



850 A* = " END DF GAME ! " : FOR B = I 

TO 15 t FOR AA = 1 TO B t VTAB 10 
: HTAB 13 : PRINT LEFT* (At, B) 
96? POKE - 14303, ? : GOSUB 31? : POKE 
- 16314, ? : NEXT AA : A « B t 13 
! GOSUB 5300 



870 NEXT B ! TEXT ; VTAB 1 : HTAB 10 
: PRINT "ANOTHER GAME'' <YXN> s ; 

880 GET A* : IF A* ■ "V THEN CLEAR : 
GOTO 10 

B90 HOME : END 

====««= BUILDING LOSES A LEVEL =«=== 

m HCOLOR a : ROT ■ ? 

91? SCALE * 7 : DRAW 6 AT Z« * 7, 

2HX - 1 : GOSUB 300 
920 SCALE ■ 9: DRAW 6 AT ZXI t 7 - 1, 

ZHX : GOSUB 300 
93? HCOLOR * 5 t SCALE = 7 ; DRAW 6 AT 

2X7, t 7, im + I 
940 ADD = - i? I LEVEL* : SOSUB 9?20 : 

RETURN 
950 IF ZH7. > EARTH + 4 THEN ZH* « 

EARTH + 4 ; CC - CC M : IF CC > 

9 THEN GOSUB 6?00 
96? ADD « - 21 I LEVEL)! : GOSUB 9020 : 

RETURN 



MOVE SATELLITE == 



105? 
110? 

1200 

1300 
1400 



2?00 
2050 
2100 

2200 



24?? 
2700 



2750 
nam 



PN* = PDL (1) / 5 ♦ 

3S THEN PN* = 38 



IF PN* > 



ROT = : 
IF PN* * 



SCALE = 1 
> PG* THEN 



HCOLOR 



DRAW 8 AT PO* t 7, 5 
HCOLOR = 3 : DRAW 8 AT PN* t 7, 

PQ* = PN* 
RETURN 



HOVE ZYPHYRS 



1 = RND (1) I 10 + 1 

IF YUFfll (!) £ 1 THEN RETURN 

8* = RND (1) I 37 M 

IF COL* (0*) > THEN GOTO 600 

UX = XUFO* (I) t 7 : X2* = 8* I 

7 

IF RND 11) t 10 < LEVEL* THEN 

SOSUB 1000 : SF* = 1 : GOSUB 600 

FOR AA ■ 5 TO 4 STEP - 1 : HCOLOR 

= AA : HPLOT XI*. YUFO* (Z) TO 

X2L YUFGX (Z) : NEXT : SOSUB 

1000 : GOSUB 5400 

COL* (XUFO* (I) ) ' 

HCOLOR = : SOSUB 200 i XUFO* 

(Z) = Q* i HCOLOR = 3 : GOSUB 200 
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2'ii'i- l£LJ, '$!U ? 1 ; RE3JRN 


313$ 


HFL0 T 140, % TO h V 




$M§ 


POKE i, A : POKE 7, 3 : CALL 765 


«*«,«*« SATSllIT? 3HCCTS ==-======* 


3153 


NEKT ft 




5i?l 


RETURN 


Ijjfgj T(T ; p r J V J 1 (. 4 






3?:? If MI «Wtt) * THEN m = 


;;-;;; 




=====EIS?lA v SlDRE ============== 


hEI&HT^ \M) - 2 : §15$ 40£ t 






hecum - £ ; a-Dsus 3:0 t return 


^$1$ 


HONE : FUFO:-: * 1 


~m :n -- mm jcgl^ ;£to> ) j Gusys 


90!0 


ADD = LE^EL"; i 100 : VTAB TY7. 1 3 


4^ ; rfCOLOR - : SDSUB 260 




* 1 ; HTftB Ml '. PRINT ADD 


3t?3f &RS.2 fi;3LS CF0.) : = : C0L2 


9020 


PTS ■ PTS ♦ ftDfJ : SCI = STR* 


fWB! s 1 : BGSUB 9SM ; GOSUB 




iPTS; i VTftB 21 : HTftB 17 ; 


5f§ : RtTSRN 




INVERSE 




?330 


FOR ft ■ I TO LEN (SOU 


=«*?**« sOiiND OF DESTRUCTION ■**«■» 


9040 


IF FUFO;! THEN POKE - 16303, 9 : 

n = peek mm 


Si#0 FOR ft = j :i] f| : POKE 6, RSI ii! 


9052 


PRW $m (50*, ft, 1! ; 


* I?- * ! ! POKE 7, 250 : CALL 76S 


?KI 


POKE - 14384,0 


; tf>: ; K;f-]jp^ 


?£S0 


NE1T : PRINT ,f " : NORMAL : IF 


310 FOR ft = 100 TO 2H STEP 20 : POKE 




PTS < - 100000 THEN GOSUB 8008 : 


6. A ; PQKE 7, 2 : CALL 763 : WM 




GOTO S50 


t K « PEEK (BUZZ! : GGSUB ft*? : 


9098 


HOHE : FifH = : RETURN 


NSf ! RETURN 






52$ FOR A = 200 TO 250 STEP 11 : POKE 


=====: 


-====MT WRIftBLES ============= 


5, ft : PIKE 7. 4 : CALL 76S i NE*T 






[ RETURN 


13000 


EfiRTH -- 152 : LEVELS = 1 ! SUN7. 


53M FDR Aft - 25! ID ! STEP - I? i 




* 5 j PTS = 8 : CC = 


POKE i, A : POKE 7, 5 : CALL 768 


|pl 


BUZZ = - 16336 : KEV = - 163S4 : 


: BUm RETURN 




KBOftRB s - 16360 : Bl = - 162B6 


HM FOR fl = i TO 3i5 STEF 3 ! POKE 6, 


18020 


HE = - 1 


ft ; POKE 7, 2 : CALL 76B : Bi : 


10830 


Z ■ i 


RETURN 


mm 


SCALE = 1 : ROT = 




18098 


IF AGAIN > THEN 12008 


&«N?i**f*r CRATER COUNTER =«====«=« 


(0100 


DATft 166.7,164,6,173.43.192,136, 
283,253,202,209,245,96,0 






6000 CI ? i ; FDR I - I TO 38 






6210 !F HEI5KTZ (!) < EARTH THEN 6l?0 






-"*■"•"•" 




6050 CC = CC M 






6060 IF CC ) 5 THEN GOSUB BSS8 : SOTO 


11008 


DATA 9,0.20,0,24,0,29,0,33,0,37, 

0,41,8,43,0.45.0,0,8 

MTA 77,45,45,0 

DATft 45,9,45,5,0 

DATA 45,77,45,0 

DATft 45,109.41,0 

DATft 77,77,5,8 


km NEKT ; RETURN 


11010 


M FOR B = 1 TO 13 : IF fUM It) ■' 


11020 


i then mt 


11030 


3010 HCQLDR ■ 1 ; NPLDT Mm £&> * 7 


11040 


+ 4, YUFOy. ft) TO m, 98 : GGSUB 
5#8 


11050 


11060 


DATA 5,8 
DATft 32,8 


09 NEXT B i SCftLE = 50 ! FOR A = 


11070 


TO 64 : ROT = ft t XDRAW 6 ftT 148, 


11030 


DATA 44,44,53,54,46,36,36,45,46, 


Wi NEXT ft 




54,0 
DATA -1 


31*0 FOR A = 1 TO 50 


11890 


3110 HCOLCfi ' RND (!) X 5 M 


11100 


START ' 763 


3120 I = RNB (1! t 230 : ¥ ■ RNE (1) t 


11110 


HEft = STftflT 


m 


11120 


READ QUANTITV 




11138 IF QUANTITY ( THEN 11200 

11140 POKE HEM, QUANTITY 

11150 m = MEN + 1 

11160 GOTO 11120 

11200 POKE 252, 15 : POKE 233, 3 



== SET UP Sft«E === 



12080 GOSUB 13000 

12810 80SUB 14000 

12020 GOSUB 14100 

12038 GOSUB 15800 

12048 SOSUB 358 

12090 GOTO 180 



HAKE EARTH 



13000 HCOLOR= 3 

13010 FOR A ■ EARTH TO EARTH * 10 

13028 HPLOT 0, A TO 279, A 

13038 NEXT 

13100 INVERSE 

13110 FOR A = 21 TO 23 : FOR AA = 1 TO 

40 
13120 VTAB A : HTAB AA : PRINT " " ; 
13138 NEKT : NEXT 
13140 VTftB 23 : HTAB 12 s PRINT 

■ > ZVPHVR WARS! fVii NORttAL ! 

I/TAB 24 ; HTAB 3 : PRINT 

■COPYRIGHT \m BY SOFTKEY 

PUBLISHING" ; 
13180 POKE 35, 19 
13190 RETURN 



=== CALCULATE BLD6S 



14008 FOR ft = 1 TO 38 
14018 HEIGHT = i RND ill t 20! t 2 
14820 HEIGHTS (A) = EARTH - HEIGHT 
14830 FOR B = EARTH TO HEIGHT* <§ 

STEP - 2 
14040 Rl $ RND (DI5H 
14058 SCALE = 7 : KDRAH 6 AT A t 7, 8 

- 1 
14060 SCALE = 1 : XDRAH RX AT A I 7, 

B 
14870 POKE 6, B : POKE 7, 5 ! CALL 768 
14890 NEXT : NEKT : RETURN 



"www DRAM STARS 



=n==E==rs£Ssrs 



14188 FOR A - TO EARTH 

14110 HC ■ - HE : HCOLOR = 3 : IF HC 

< THEN HCOLOR = 7 
14128 STAR * RND (1) I 279 + 1 
14130 HPLOT STAR, A 
14148 POKE 6, A * 1 : POKE 7, 9 : CALL 

768 
14150 NEKT 
14190 RETURN 

»»====»= CALCULATE UFOS =======»=** 

15080 FDR fl = i TO 18 

15018 T7, = RND (1) ( 37 t 1 i IF COLX 

ill) > THEN 15810 

15820 KUFOi (A> = TS 

15830 YUFOX (ft) » M 8 * 12 

15840 HCOLOR = 3 : I = ft : GOSUB 200 

15050 COLX (TI) = ft 

15068 NEKT 

15098 GOSUB 368 : RETURN 



<•?-> 



-100840 
> ZYPHYR WARS < 



(3> 
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Last issue's column presented to you 
my program 'Artist's Easel' as an intro- 
duction to the world of Apple Computer 
high resolution graphics. This column 
will cover how to access the graphics 
screen from the monitor ana from BASIC 
programs. 

2 Hi-Res Screens 

The Apple has two hl-res screens, 
each of which occupies 8K of RAM. 
Screen 1 resides from S2000-S3FFF 
{8192-16383] immediately followed by 
screen 2 at S40O0-S5FFF (16384-24575]. 
These two areas do not become active 
or displayed until certain 'soff switches 
are thrown. These switches are special 
memory locations which, when refer- 
enced, activate the hardware neces- 
sary to view these screens. Table 1 
shows the locations of the switches and 
their functions, 



set hex denial 



function 



1 C058 -16304 display graphics 
C851 -1630! display text 

2 C052 -16302 full screen 

C053 -16301 lixed text/graphics 

3 C054 -16300 display page 1 
C$55 -16299 display page 2 

4 C056 -16298 display lo-res 
C0S7 -14297 display hi-res 

Apple's normal configuration, which 
exists on power-up or after a Reset, is: 

text mode, 

pagel, 

mixed text, 

and lo-res switches 'ON' 

(Since the text switch is 'ON' the lores 
screen is not displayed]. 

Each pair of switches is a comple- 
mentary set. That is, when one Is 
switched ON the other is switched OFF, 
therefore only one instruction is neces- 
sary to change configurations. 

BASIC POKES 

To activate a switch from BASIC 



requires a simple POKE. 

A POKE -16304,0 (POKEing any value 
will suffice] will change from text to 
graphics - but exactly which graphics 
mode depends on which switch from 
set 4 is ON, 

From the monitor it is even easier; just 
type the hex value of the switch and hit 
Return, The monitor will return a value 
(meaningless] and the switch will be 
thrown. 

Try this example. 

Soft Switches 

Power up and hit Reset. If not in the 
monitor (asterisk prompt **■% enter CALL 
-151. 

Now type C050 and hit Return. 

You are now in graphics mode ( lo- 
res-mixed-page 1 ]. 

Now type each of the following 
instructions and observe the changes: 

C057 return -- Hi-res page 1 

C055 return -- Hi -res page 2 

C$52 return — Full screen 

C051 return -- Text page 2 

C854 return — Text page 1 

Notice how you went from hi-res to 
text and from page 1 to page 2 (page 2 
text does not show keyboard entry]. 

From The Monitor 

Now enter this short program from the 
monitor: 
0300ISD 50 C0 8D 52 C0 BD 57 C0 8D 54 
C0 BD 55 C0 20 09 03 



Now type: 




300L return 




You should see: 




0300: 8D 50 C0 


STft cm 


0303: 8D 52 C0 


STfl C052 


0306: 3D 57 C0 


STA C057 


0309; BD 54 C0 


STfl C354 


030C: 8D 55 C0 


STA C055 


030F: 20 09 03 


JSR 0309 



This will set graphics, full screen, hi- 
res, page 1 , page 2 then loop continu- 
ously, alternately displaying page 1 
and page 2. 

Now type; 

3006 Return 



To stop it, hit Reset 

Notice that only a simple STA instruc- 
tion is necessary to access each switch. 

Program 1 

Now from BASIC enter and RUN the fol- 
lowing program, This does the same as 
the machine language program but at 
BASIC'S slower speed. 

100 POKE -16304,0 

200 POKE -16302,0 

300 POKE -16297,0 

400 POKE -16300,0 

500 POKE -16299,0 

600 GOTO 400 

HGR To HGR2 

Here is what occurs when a com- 
mand of HGR is entered from Applesoft: 

a. The switches at C05©, C053, C054, 
C057 are thrown; 

b. A routine which places alt zeroes 
from S2000-S3FFF is executed which 
clears the screen to all black; 

c. And a S20 [32] is stored in memory 
location $E6 (230) which tells the draw- 
ing routines that page 1 is to be drawn 
on. 

A HGR2 throws the fullscreen switch 
C052 and page 2 switch C055 and 
places a $40(64] at SE6 (230) as well as 
clearing the screen. 

Because HGR and HGR2 clear the 
screen to black, these commands are 

generally used to first initiate a graphics 
program . 

However, it is often desirable to load a 
picture before displaying the screen so 
as to avoid the delay encountered in 
clearing the screen and loading a pic- 
ture from the disk while the screen is dis- 
played. This is where it is necessary to 
utilize the screen switches. 

Lines 100-400 of program 1 will 
accomplish this without erasing the 
screen. 

Another example is shown in the fol- 
lowing two programs which demon- 
strate different ways of animating a 
moving figure, 

Program 2 is a short, fast routine which 
suffers from the characteristic flicker 

continued 
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continued from page 43 

resulting from single-screen animation. 
The other one is much more complica- 
ted but results in smoother motion. It 
also shows an alternate way of turning 
on the screens which does not show the 
screens until after they are cleared. 

Examine these programs and see 
how the various methods of screen 
switching have been employed and 
how you can use them In your pro- 
grams, Next issue I will present some 
methods of screen manipulation 
including some assembly routines 
which can be used to combine several 
pictures or to change colors or even 
turn pictures upside down. 

Until then, happy drawing! 



Program 2 



m REM SIMPLE ANIMATION 

ON ONE SCREEN 
15<J HSR : POKE - 16302, I : REM 

CLEAR SCREEN AND SET FULL SCREEN 
m SOSUB 550 : REM ENTER SHAPE TABLE 
253 FOR XC =t TO 26B STEP 2 
m XDRAH J AT £t, m I REM DRAW CAR 
350 XDRAW I AT XC. 100 ; REM ERASE 

CAP 
m NEXT 
453 END 
m REM FOLLOWING DATA IS A SHAPE 

TABLE WHICH IS POKED INTO MEMORV 

A? WiW 
558 DATA !i 4, if, 45, 45,54,54, 45, 45, 

54,42, 55,52,39,41.43. 63,54,41,34, 

63, 34, 34, 37, 37,37, 45,0 
bU FOR i « 763 TO 7% i' READ SV : 

POKE X. SV ! NEXT 
45? POKE 232, @ : PQKF 233, 3 : RE* 

FNTFfi SHAPE TABLE START ADDRESS 



W SCALE = 1 : ROT = 

750 RETURN 

Program 3 

m REM MORE COMPLEX ANIMATION 

USING TWO SCREENS 
150 POKE 230, 32 : CALL 62450 : POKE 

230, 64 : CALL 62450 : POKE 

- 16304, ! POKE - 14297, 1 

POKE - 16302, : POKE - 16300. 

; REM CLEAR BOTH SCREENS BEFORE 

DISPLAYING THEM 
2M GOSUB 950 : REM ENTER SHAPE TABLE 
250 FDR XC ' TO 266 STEP 4 
300 HCOLOR ' 3 f REM WHITE 
350 POKE 230, 32 : DRAW 1 AT XC, 100 : 

REM DRAW ON SCREEN 1 
400 POKE 230, 64 ; DRAW 1 AT XC t 2, 

100 ; REM DRAW ON PAGE 2 
450 POKE - 14299, : REM DISPLAY 

PAGE 2 
500 HCOLOR = 
550 POKE 230, 32 ; DRAW t AT XC, 100 : 

REM ERASE PAGE 1 
600 HCOLOR = 3 
650 DRAW 1 AT XC + 4, 100 : REM NEW 

PAGE i 
700 POKE - 16300, : REM DISPLAY 

PAGE 1 
750 HCOLOR = 
800 POKE 230, 64 i DRAW 1 AT XC + 2, 

100 : REM ERASE PAGE 2 
850 NEXT 
900 END 
950 DATA 1,0,4,0,45,45,54,54,45,45, 

54,62,55,42,39,60,63,43,54,43,34, 

43.34,36,37.37,37.45,0 
1000 FOR I = 743 TO 796 : READ SV : 

POKE X, SV : NEXT 
1050 POKE 232, : POKE 233. 3 : REM 
ENTER SHAPE TABLE START ADDRESS 
1100 SCALE « 1 : ROT ■ 
1150 RETURN 



REBUTTALS 



continued from page 10 

when a computer owner copies a disk 
and passes it out to all the members of 
his family? Or to his best friend? Or to his 
best friend's best friend? 

Also, where does a corporation 
stand? A corporation, whether it be an 
incorporated user's group or an actual 
business, is recognized by law as an 
individual. As an individual, can corpo- 
ration purchase one copy of a program 
and make copies for all of its employ- 
ees or members? Isn't that within the 
constitutional rights of the corporation 
as an individual? 

I am not saying that we should go 
from one extreme or the other. All I am 
trying to point out is that we should not 
be so blinded by our own selfish views 
that we fail to see the legitimate con- 
cerns of the 'other side.' This applies to 
all concerned. 



If we attempt to look at it logically and 
really be fair, it seems that we could 
come up with a rather equitable solu- 
tion for all concerned. If we adopt an 
attitude of 'damn the companies' or 
turn our noses up at users, we only hurt 
ourselves. Perhaps it is time to take BOTH 
sides into account. 

As an afterthought, how would you 
feel about a company photocopying 
HARDCORE for all of its employees, thus 
depriving you of many possible sub- 
scriptions? The analogy is about the 
same, even if the media is different. I 
would definitely be Interested in an 
answer. 



Sincerely, 

Allen L Wyatt 

Advanced Operating Systems 

Michigan City, IN 




continued from page 25 

an "uncrackable" program. 

I would like to take some time to join you on 
the soap box. There is a significant difference 
between copying a program disk, and 
"breaking" the disk. 

To copy a disk, one only has to figure a way 
to recreate the same pattern of bits on the 
new disk that was on the old. 

To "break" a disk is another matter entirely. 
This refers to removing the nonstandard 
encoding, and "normalizing" the programs. 

A normalized program can be run with nor- 
mal DOS. A normalized program can be 
modified (and corrected if need be), A nor- 
malized program can be integrated easily 
into a system. 

The proceaure to normalize Is far more 
complex than a simple copy 

Copying in some manner will always be 
possible, and some software manufacturers 
have learned to live with it, The point of this is 
embodied in a program called ASCII 
Express. This program Is heavily protected 
and yet is copyable, within limits. The copy 
program is on board, and so Is a copy 
counter, The user may make up to4 copies of 
the original and thus have 4 backups. Had 
every programmer of commercial software 
been so enlightened. Locksmith, Nibbles 
Away, and other copy programs would never 
have been necessary (Even Hardcore would 
likely not have come into existence.) The 
worst that can happen is that the copies of 
the software fall into 4 unauthorized hands. 

There are some users who get considera- 
ble enjoyment from just "breaking" a pro- 
gram. They usually don't do it to deliberately 
pirate programs; it Is simply an intellectual 
exercise and sometimes an egotrip. They sel- 
dom use commercially available copy soft- 
ware, preferring to write their own. They are 
thus constantly adding to their own knowl- 
edge of computing, and through their writ- 
ings, they add to others, These people are a 
minority, and probably always will be, but 
they do exemplify the meaning of the term 
"Personal Computer," 

I try to avoid pirated audio recordings, and 
pirated video, and if I pay for a program, I 
would feel like a fool to give It away to some- 
one else, so I don't, 

I have on occasion though, borrowed (and 
lent) software. 

I have an extensive fiction library (several 
hundred volumes) and have never hesitated 
to lend a book from it to someone else, nor 
have I hesitated to borrow one. By the strict 
letter of the law, I am In violation of copyright 
law each time I either lend or borrow a book. 
If anyone thinks that I am going to stop bor- 
rowing or lending books (or programs), they 
couldn't be more wrong! If that makes me a 
pirate, so be it. 

I sympathize with the programmer who has 
spent hundreds of hours creating a piece of 

continued on page 63 
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: un-and_FactS-Concerning_DBAW_ancLX[ 



me tables 

fiRA W 
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The Applesoft graphics commands 
are familiar to most of you. In this 
column I'll be covering the least-used of 
those commands: those that manipu- 
late Applesoft "vector graphics". 

These commands are: 
1. DRAW n 
2,DRAWnATx,y 
3. XDRAW n 
4.XDRAWnatx,y 
5.5CAL£= n 

6. ROT= n 

We'll also be using those commands 
that are familiar to you: 

7. HCOLOR= n 
8.H6RandHGR2 
9.HPLOTx,y 

10. HPLOT x1 , y1 TO x2, y2 TO x3, y3 
H.HPLOTTOx3,y3 

And we'll be POKEing the following 
addresses (with zero). These are the 
locations of the Apple SCREEN SOFT 
SWITCHES and include: 

(switch) (address) 

1 . Hi-Res display -1 6297 or 49239 

2. Lo-Res display -1 6296 or 49238 

3. Page 2 display -1 6299 or 49237 
4 Page 1 display -16300 or 49236 

5. Mixed screen -1 6301 or 49235 

6. Full screen -16302 or 49234 

7. Text display -1 6303 or 49233 

8. Graphics display -16304 or 49232 

In order to use a shape table, we'll 
also be POKEing the address of the start 
of the shape table in location 232 and 
233 (pointer to the shape table index). 
We might a)so be setting LOMEN or 
HIMEM. Furthermore, to make the pro- 
grams more aurally interesting, we'll 
also be PEEKing the speaker (-16336 or 
49200), 

And in later articles, we'll also be 
using these addresses; 
decimal (hex) (purpose) 
234 (SEA) Collision counter 
228 ($E4) Hi-Res color byte 

226 ($E2) Hi-Res Y coordinate 
225 ($E0) Hi-Res X coordinate 
Before we can use the DRAW and 
XDRAW commands, however, it will be 
necessary to first make a shape for the 
commands to DRAW. Neglecting this 
step will have interesting effects espe- 
cially if, when it tries to DRAW on one of 



the Hi-Res pages, your program also 
resides there. In fact, your system may 
even "hang" if it DRAWS over page one 
of memory and over your DOS, 

A shape table consists of a shape 
index and the various shape definitions. 
The shape taPle Index lists the number 
of shapes in the table and then consec- 
utively lists how far the starting address 
of each shape definition is from the 
beginning of the table. Each shape 
definition consists of o list of vectors 
(either plot or non-plotting). It might help 
to have your Applesoft Reference 
manual open to page 92 while I run 
through the preliminaries. 

Vectors are simply directions of travel. 
In this case, we have only 4 vectors or 
directions: 

(direction) (definition) 

4. go UP 00 

2. go RIGHT 01 

3. go DOWN 10 

4. go DOWN 11 

The definitions are the bits (remem- 
ber, 8 bits make up a byte?) that tell the 
DRAW and XDRAW routines which direc- 
tion to move. To this definition we must 
add another bit to tell the routine 
whether or not to plot: 
1 PLOT 
DON'T PLOT 

These three bits are then combined to 
fill out a byte. But since a byte has only 8 
bits, we are left with a problem: three 
sets of three bits make 9 total. There's 
one bit too manyl 

Here's a sample shape definition 
byte: 10111010 

The DRAW routine reads this byte from 
right to left in this manner: 

io*-m <-oio«- 

These are the three "steps" it takes 
when it reads a byte. 

1. It first sees "010" as "0" and "10" 
which means to move down without 
plotting, (10^go down, and = not to 
plot) 

2. It then reads '111' as '11' and '1' 
which means to move left while plotting. 
(1 = plot, and 1 1 = move left) 

3. Finally, it sees '10' which it interprets 
as '0' (implied by the absence of that 
mythical 9th bit) and '10' which 



together means to move down again, 
without plotting. 

As you can see, the third step can 
never be a plotting vector. That means 
that if you did want to plot while moving 
down, you'd have to put '00' in its place 
and go to the next byte. The first step in 
that next byte would then be ' 1 1 0.' 

Remember, zeros are important. Put 
2eros in certain instances will be 
ignored, or worse, translated as the 
'End of shape.' For example, whenever 
the DRAW/XDRAW routine reads a pair 
of zeros in step 3, it ignores them and 
proceeds to the next byte. But it wili olso 
ignore a set of three zeros in step 2 if a 
pair of zeros occupy step 3. Now that sit- 
uation poses some problems. 



Some Problems 



1. According to the definition table, 
'00' means to 'go up.' But if that vector is 
placed in step 3, it will be Ignored! So if 
one must go up, if will be necessary to 
place that W in step 1 of the next byte. 

2. Also according to the definition 
table, '000' means to 'go up,' too, with- 
out plotting. But if that vector is placed 
in step 2 and is followed by a '00' in step 
3, it will also be ignored. Again, one 
must place the '000' in step 1 of the next 
byte, 

3. A byte consisting of all zeros means 
'End of shape,' so one cannot end with 
a non-plotting vector going up. Nor can 
one have a series of non-plotting vec- 
tors going up. So how does one vector 
up a distance without plotting if it is 
translated as 'that's all folks!.' That wilt 
be one of the problems solved next time 
when I delve into more complex shapes 
using a 'shape-table maker' program. 
Meanwhile, think about it, 

Without that program to help make 
the 'shapes,' you'll have to do it the 
hard way. But, interestingly enough, the 
hard way is the best way to learn about 
shape tables in general. 

Have some graph paper handy (with 
4 to 5 squares to the inch). The shapes 
will be mercifully simple: a plotting 
dash, and a plotting square. The first 
shape will be a dash . . . 

continued on next page 
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On your graph paper it would look 
like this; 



We'll adopt your manual's symbols 
and write it like this: 



. i. ..',.. 



--L 



en ;•*•; OR. 



OR. 



UP RJ&HT DOWN LEFT 

As you can see, there are 4 ways to 
draw the dash vectors: the 4 directions. 
We'll do it all 4 ways and translate it into 
the actual vector codes representing it, 
and the actual shape definition byte, 



Vector: UP RIGHT DOWN 

Code: 10) 1B1 m 

Byte: M8M1H 988901 fH 88988^0 

Hex: $84 SOS S06 

Decimal 4 5 6 



LEFT 

HI 

H 

$87 

7 



We arrived at the shape definition 
byte by filling in steps 2 and 3 with zeros 
(The hex translation is provided in case 
you wantto use the monitor), Its decimal 
equivalent is provided for those who 
want to POKE in the values from Apple- 
soft. Use the 'NIBBLE/HEX' table when 
translating the byte into its hex equiva- 



CONVERSION 


CHART 


NYBBLE- 


HEX- 


DECIMAL 


0000 


*0 





0001 


*1 


1 


0010 


*2 


2 


0011 


*3 


3 


0100 


*4 


4 


0101 


*5 


5 


0110 


*6 


b 


0111 


*7 


7 


1000 


*8 


B 


1001 


*9 


9 


1010 


*A 


10 


1011 


*B 


11 1 


1100 


*c 


12 


1101 


*D 


13 


1110 


*E 


14 


1111 


#F 


15 I 



Vector Codes 




NON-PLOTTING 





Vector 


Code 




UP 


000 




RIGHT 


001 OR 


01 


DOWN 


010 OR 


10 


LEFT 


011 OR 


11 


PLOTTING 





Vector 


Code 




UP 


100 




RIGHT 


101 




DOWN 


110 




LEFT 


HI 





lent. To get the decimal equivalent, use 
the BYTE CONVERSION CHART in Update 
2,1, your own hex-decimal conversion 
program or, with some work on your 
part, the table on page 1 5 of the Apple 
II Reference Manual. 

There! You now have a shape defini- 
tion. But to use it, we'll have to put it into 
a shape table. Because we are using 
small shapes of relatively few bytes, let's 
put our shape table on page three of 
memory We first have to make a shape 
table index consisting of the total num- 
ber of shapes and then, consecutively, 
a list of each shape definition's starting 
position relative to this 'start of table.' In 
this example, there is only one shape. 
Reading down the column, you will see 
a sample shape table: 

hex decimal explanation of byte 

01 1 total numberof 

00 shapes 

04 4 index to first byte of 

00 shape # 1 

04 4 shape definition # 1 " 

00 end of shape 

(* ' This is the dash going up. You can 
put any of the four dashes in this posi- 
tion.) 

There are two ways to enter this table: 

1. Use the Monitor. 

2. POKE it in directly or via a program. 
The memory location we'll use for our 

experimental shape table is S300 hex, 
768 decimal. 

To use the monitor: 
1. Type: CALL -151 
2 Type: 300:01 00 04 00 04 00 Return 

3. Press Reset to return to Applesoft 
[autostart ROM only) 

In this example, we'll POKE in the table 
from inside a program. In this way, you'll 
immediately see if you have made an 
error in translating your shape vectors 
into the proper byte code. 



10 REM FUN WITH SIMPLE SHAPES 
100 POKE 232,0: POKE 233,3 
110 DATA 1,0,4,0 
120 DATA 4 
130 DATA 0,-1 
140 ADDRESS- 768 
200 READ A 
210 IF AK0 THEN 250 
220 POKE ADDRESS, A 
230 ADDRESS = ADDRESS + 1 
240 GOTO 200 
250 HGR 
270HCOLOR=3 
280 HPLOT 0. 
290 CALL 62454 
500 FOR A = 1 TO 20 
510SCALE = A'2 
540 ROT =0 

550XDRAW1 AT 10* A, 80 
580 NEXT A 

In line 100, the pointer to the start of 
the shape table was POKEd. Although 
the decimal location is 768, we must 
poke two locations with the double byte 
equivalent of the decimal number of 
768. This is easy to do since we know 
that the hexadecimal location is S300. 
Breaking it into two bytes, we have S3 as 
the upper byte and S00 as the lo-byte. 
That easily translates to decimal equiv- 
alents of 3 (hi-byte] and (lo-byte). 
Addresses are stored in 'reverse order,' 
so we put the lo-byte in location 232 
and the hi-byte at 233. 

Lines 110- 130 is our shape table (and 
line 120 is our lonely shape definition) 
conveniently stored in DATA statements. 
As we go through this exercise, you 
should make changes in line 120 and 
RUN the program whenever you want to 
change the shape definition. 

If you RUN this program, you'll get 20 
images of your dash oriented just the 
way you originally specified the vector 
. . . in 25 sizes or SCALES. 

You can now experiment with the 
shapes. Plug in a 5, 6 or 7 in place of the 
'4' in line 120. As you can see, they are 
all dashes, but pointing in the four 
directions, pure vectors . . . 

To see what a simple dash can do, 
add in these lines: 

520FORB 1T064 
540 ROT= B 

550XDRAW1 AT 139, 79 
570 NEXT 

Now you have a rotating dash that, 
after one full revolution, gets a little 
larger and rotates again, and so on. 

Make this change and you'll myste- 
riously get vanishing lines: 
540 ROT - B * 2 

If you like, try this change: 
550HCOLOR-RNDMP7 + 1 
560 DRAW 1 AT 139, 79 

Now the color will be solid, and color- 
ful... but may sometimes be black. 
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Your dash can also go crazy and 
dash all over the place. For a crazy 
dash, make these changes: 
4MSC=RNDM)*20+ i : SCALE = SC 
410 RO #RND (1) * 64 + 1 : ROT= RO 
420XDRAW1 
450 GOTO 400 

Now RUN it. The first thing you should 
notice is that when the dash runs off to 
one side. It reappears on the other. By 
purposely not specifying the X and Y 
locations, the XDRAW command will 
tack one dash onto the tail of the other, 
making worm tracks all over the screen. 

For your own amusement, you can 
add noise: 
430 NOISE = PEEK H 6336) 

So much for dashing dashes . . . Now 
on to another simple shape: an off- 
centered square. The smallest such 
square looks like this on your graph 
paper: :>_.;.. 

It is called an 'off-centered' square 
because one begins drawing it's vec- 
tors at a corner and not at the center. 
This imparts certain characteristics to 
this square, The square can be drawn 
using all four different vectors. Like the 
dash, we can begin at any of the four 
vectors and end up with a square as 
long as we use them in the proper 
order. The four different squares are: 

J *» ( •-• J *• | *> 
•* j *-* \ «*{*»{ 

* r * T ' T 1 V 

♦• i **■ * ** t "** T 

i 2 3 t 5 6 7 8 

CLOCK-WISE COUNTER. CLOCK- WISE. 

Let's take the first square and change 
It Intoashape table: 
(code) (byte) hex decimal 

100 00000100 $04 4 

101 00000101 $05 5 

110 00000110 $06 6 

111 0000 0111 $07 7 
From this, it appears that the shape 

definition of a square consists of four 
bytes: 

4567 

But we only use a third of each byte to 
Indicate a vector. Let's use the entire 
byte and conserve memory: 
00 + 101 + 100=00101100=$2C = 44 
00+ 111 + 110=00111110=$3E = 62 

Remember, we fill in the byte from 
right to left and, since all four vectors 
are plotting, we've had to leave step 3 
empty (00). Now our shape definition 
takes up only two bytes, And believe 
me, when you have a lot of shapes to 
store, every byte you save leaves more 
room for something else (program 
space, graphics, etc.). 



Make this change in your program: 
120 DATA 44,62 
300 GOTO 500 

your program will now rotate the 
square instead of the dash. Here's an 
expanding square (if you make this 
change): 

300 FOR A=1 TO 50 
310 ROT = 
320 SCALE = A 
330 XDRAW 1 AT 179, 80 
340 NEXT 
390 END 

Try making this change: 
310 ROT = A 

Or this: 
310ROT = A*2 



Table With 2 Shapes 

in order to use both the dash and the 
square, your shape table must be mod- 
ified to include both definitions and 
both indices. 



table bytes awa, j 

values Iron start explanation 

2 6 nunber of shapes 
g I in this table 

6 2 number o* c/tes to 

g 3 the first shape 

8 4 rtusiber of bytes to 

i 5 the second shape 



first shape 

end of f 3 >st shape 

second shape 
end of table 



If you examine the column titled 'Bytes 
away from start' you will note that the 
beginning of a shape definition corres- 
ponds to the value place in its index. For 
shape 1 that number Is 6, and for shape 
2 that number is 8. When this table 
grows to Include a great many shapes 
(maximum is 255), all the other shape 
Indices are calculated in a similar man- 
ner. Of course, the start of the first shape 
must move as the list of indices grows. 

As you have seen, there are many 
ways to 'make' any particular shape 
depending upon how you intend to use 
the shape. This will be the topic of the 
next installment. 



* 4 


6 


1 


7 


26 


a 


33 


9 


i 


10 



FINANCIAL 
MANAGEMENT 
SYSTEM II 

A HOME AND BUSINESS 
ACCOUNTING SYSTEM 
FAST -EASY TO USE 

Enter an entire month's CHECKING, 
CHARGE CARD, and CASH accounts in 
just a tew minutes using your own person- 
alized macro lists. INSTANT ERROR 
CORRECTION. Audit all files by Code and 
Month with year-to-date totals. PERFECT 
FOR TAX ACCOUNTING. 

• SELF PROMPTING, ERROR AVOID- 
ING ENTRY SYSTEM. 1 to 3 KEY- 
STROKE entries with AUTOMATIC 
DATE, CODING and NUMBERING. 

• SCREEN and PRINTER routines for 
listing files, balance, reconcile, search, 
and audit reports. Configure system to 
match almost any printer. 

• BUDGET MANAGER to plan, review 
and balance your budget, generate 
COMPLETE reports for any 1 - 12 
month period. 

• SEARCH all files with specific and 
expanded searches. 

- ACCOUNT AUDITOR totals all files by 
Code and any 1 - 1 2 month period with 
year-to-date totals. 
Enter your own Item and Code Macros, 
up to 100 each. 

- 48K with ROM APPLESOFT and DISK 
required. SINGLE or DUAL DISK com- 
patible, (printer optional) 
PRICE $39.95 

i 

*****NOW AVAILABLE* 

CHECK WRITER II for FINANCIAL 
MANAGEMENT SYSTEM II. Print your 
checks directly from FMS II files. 

PRICE $19.95- ($15.00 if ordered with 

FMS II) 

GROCERY LIST 

A USEFUL HOUSEHOLD PROGRAM 

DESIGNED TO ORGANIZE SUPERMARKET 

SHOPPING 

Shoppers will INSTANTLY be able to use 
this easy, self-prompting program. Scan a 
file of up to 500 USER DEFINED ITEMS. 
Choose those needed with a single key- 
stroke. Then print a shopping list OR- 
GANIZED BYTABLE NUMBER, SECTION, 
or four letter code such as "DARY", 
"BAKE", or "DELI". 

" 32 -48K with diskand printer required, 
(APPLESOFT) 

' PRICE $19.95 

COMPUTERIZED 
MANAGEMENT 
SYSTEMS 

b|j RJARVIS COMPUTING INC. 

1039 Cadiz Dr.- Simi, CA 93065 

PHONE (805) 526-0151 

Check, VISA si MASlEfi CAflD accepted. 

DEALER INQUIRIES INVITED 
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Three publishers of software ore 

examined Inthis column: 
\ . HAYDEN BOOK COMPANY 
They requested inclusion in this 

column and sent a sample contract. 

2, BRODERBUND SOFTWARE 

A well-done Author's kit was supplied 
upon request and included a sample 
contract, an illustrated booklet reveal- 
ing their products, introductory letter 
explaining 10 reasons why you should 
join their team, sample game docu- 
mentation, and a personal letter 
explaining that they are very flexible 
with their royalty policy which is 20%- 
25% on games, more for business pro- 
gram, may Include outright purchases, 
flat price per copy sold, and even 
advances. 

3. INSTANT SOFTWARE 

Their submission package included a 
sample contract and literature on sub- 
mission procedure, style guides, com- 
monly asked questions, and even hints 
on where to get ideas for new software 
packages. 



Because most software houses have 
similar contracts, I will try to contrast 
these three under the categories of: 

1. Rights sold 

2. Royalty 

3. Contract time 

4. Program Submission 



Copyrights 



All three purchase all and exclusive 
rights [both copyrights and intellectual 
rights to your program(s). That means 
that the publisher owns that program 
and any program you write that is simi- 
lar enough to it to qualify as infringe- 
ment of those rights. The puPlisher also 
gets all versions, updates, etc. of that 
program. 



Royal $$ 



Royalty is usually based upon a per- 
centage of the cash received for the 
sale, tease, etc. of the program minus 



cost of returns, allowances, discounts, 
collection fees, transportation and 
postage, taxes, etc. though these vary 
from contract to contract. Royalty can 
also be a stated amount per program 
actually sold regardless of product 
price or gross cash receipts. Of course, 
when more than one program makes 
up a product, royalty must be divided 
up among the authors. 



Contracts 



HAYDEN BOOK COMPANY 

50 Essex Street 
Rochelle Park, NJ 07662 

—Rights sold: 

All rights including exclusive rights 
and subsidiary rights. Also first options 
on all versions for any system and all 
future versions, 

—Royalty: 

AMOUNT NOT STATED, based on 
actua! cash received by Publisher and 
paid quarterly to author, 

—Contract time: 

NOT STATED, however. If the program 
is not kept "in print" and "for sale" for 
any two year period, then 90 days after 
written demand from author to reprint 
the program, the contract is terminated 
and all rights revert back to author. 

—Program submission; 

Author supplies Publisher with three 
copies of program within 2 weeks of 
signing contract, along with necessary 
documentation and source code. Pub- 
lisher has 12 weeks to determine publi- 
cation acceptaPliity 



BRODERBUND SOFTWARE 

2 Vista Wood Way 
San Rafael, CA 94901 

—Rights sold: 

Exclusive rights. 

—Royalty: 

NOT STATED, a flat royalty per copy of 
work sold regardless of selling price of 
copy and paid monthly to author 
(according to the sample contract]. 

—Contract time: 

Ten years; or 6 months after either 
publisher or author gives written notice 
of termination. 

—Program submission: 

Send them a copy of your program 
by Registered Mail. There is a brief two 
day evaluation period. Please include 
necessary documentation, your 
address and phone. 

-Other: 

Author must make revision at own 
expense, and failing to do so, publisher 
may have another party make the revi- 
sions and charge the cost against the 
author's royalties. 



Some publishers require a signed 
contract before examining your pro- 
gram, others after evaluation and 
acceptance. Some take an awful long 
time to decide, others will tell you within 
a few days whether they want your pro- 
gram or not. 

Also some publishers require you to 
make revisions and alterations, or they 
will get someone else to do it for you 
and pay him out of the royalty that you 
would have gotten, 

Contracts are a part of business, so 



INSTANT SOFTWARE INC 

Peterborough, NH 03458 

—Rights sold: 

All rights, exclusive rights, and options 
on derivative works and versions, 

—Royalty: 

20% of gross cash receipts, paid 
quarterly to author. 

—Contract time: 

NOT STATED, but if the publisher does 
not publish, distribute and sell the pro- 
gram within 1 year after signing con- 
tract, then author need only give written 
notice to terminate the contract. 

—Program submission: 

You must sign the contract first, then 
send a copy of the program with con- 
tract and documentation. The evalua- 
tion period is up to 12 weeks (filled in a 
blank space In contract], 

-Other: 

If author does not make changes as 
specified by publisher, then publisher 
can get someone else to do it and 
deduct the cost from the author's royal- 
ties. 
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examine yours carefully Get a lawyer to 
explain what the terminology really 
means. And if you have complaints or 
praises as a result of your experiences 
with various publishers, let me know. 
This column is for you, the software 
writer. Your experiences can help others 
make decisions regarding who shall, 
and how to, market their programs. 

All three state .in their contracts that if 
the author is accused of copyright 
infringement, it is up to the author to 
defend himself, and if the puPlisher is 
harmed, then the author must indem- 
nify the publisher for that toss. 



is important that publishers have many 
dealer outlets as well , 

According to Instant Software, "our 
authors earn an average of 3 times as 
much from wholesale orders we get 
from our dealers." Broderbund boasts 
over 700 dealers. 



Advance $ 



Dealers 



One of the best ways to see how your 
program will be marketed by the pub- 
lisher is to see how they have treated 
others, Examine the ads in magazines, 
check out your local computer outlet, 
and watch this column space, Ads in 
magazines sells your program, and 
interests others to buy them at their 
dealer outlets, Dealers can show off 
your program directly to customers, so it 



Another item worth investigating is the 
suPject of advances, or prepayment of 
royalties before the program is mar- 
keted. In this way, the author gets finan- 
cial support (SS$) and encouragement 
(because S$S up front means that the 
publisher is certain of making a profit 
from your program,) Of the three, only 
Broderbund, in its author's kit, comes 
out and says, "Advances are standard 
for most new products," 

However, before sending your pro- 
gram off to any publisher, look around, 
ask for their submission packages and 
sample contracts, compare and con- 
trast them, check with a lawyer, and 
then choose. 



= FOCUS' AAA = 

continued from page 16 

computer stores use my library, but for 
another reason. They give away the volumes 
to Apple buyers to help stimulate their inter- 
est," 

"My goal for AAA, however incomplete, is 
to continue to provide Apple owners with not 
only public domain software, but an entire 
range of commercial software and accesso- 
ries at very low prices." 

For more information about the AAA, call 
Ron Maleika at (3071 632-6561 or write to the 
Apple Avocation Alliance, Inc., 721 Pike 
Street, Cheyenne, Wy 82009. 

[Editor's note: I have not actually used any 
of the programs from Ron's library and can- 
not make judgments on the quality of the pro- 
grams, From reading some of the literature, I 
garner that some programs need work and 
are listed as such. The quality of the public 
domain library continues to increase as sub- 
scribers write in with fixes and completions to 
such programs. I am impressed by the quan- 
tity. Let me know about the qualityl) 



ijaa a asa gaac&was asaaasacswawa 
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Your Tipple too slow ? 
Not anymore • • . 



Now you too con write 6809 programs for your Apple II rhot are 
DOS 3 3 compatible. But you don'r hove ro stop there, you con 
also program your Apple Ils6502 and the 6809 of THE MILL to run 
SIMULTANEOUSLY. 

THE A5SEMBLER DEVELOPMENT KIT induding THE MILL is o full 
feature assembler, designed to use the rexr editing system of your 
choice. The sysrem will also boost your computer programming 
productivity, since the 630° is Today's easy to learn and program 
computer. Take advantage of the 6-bit 6502 and the 16-bit 
abilities of rhe 6809 running or the some Time, create your own 
MULTIPROCESSING ENVIRONMENT on rhe Apple II. 

PutTHEMILL into your Apple li and ger power, performance ond 
price matched by no other personal computer. STELLATION TWO 
offersafull 1 yearworrontyanda60 day money back guarantee, 
if you're nor completely satisfied with rhe power of THE MILL 

Shop around, then compare rhe service, quality, price and 
power of THE MILL. Take this ad ro your local Apple Dealer and see 
the endless possibilities of odding THE MILL to your Apple II. 




THE MILL transforms the d-bit Apple II 
inro o computer thor acts like a 
1 6-bit machine, THEMILLhas 
unique hordware feorures Thar 
permfr rhe 6809 ro run ar full 
speed (1 megahertz) and 
allow The 6502 to run or 
20% of its norma! 
speed — 
ATTHESAMETIME! 




Find our about 
THE MILL and get 
involved wiih rhe 
horrest irem on rhe 
personal computer 

ma rker today. 
Noexisring personal a 
con g ive you rhe powe 
performance ond price ofTHEMILL'5 

6809-6502 combination. 






ar*fei£ 



■SBESr 










PO. BOX 2342 -H3 

5ANTA BARBARA, CA, 93120 

(805)966-1140 



Apple is a trademark of Apple Computer, inc. 
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ADVENTURE TIPS 



continued from page 18 

2 were too unreasonable to play To this I 
soy 'Hogwash'! Now don't get upset. 
The only reason that I can say this is 
because I have just recently obtained 
maps of both. So now you can say 'Hog- 
wash,' too! 
ADVENTURE IN TIME 

Adventure In Time is rated by Phoenix 
as a class 4 adventure. I don't know 
what they base this rating on, but I 
found the adventure to be relatively 
easy. I also found it to be rather enter- 
taining, and on that note I do recom- 
mend it. A map is availaPle for that 
program too. As for a couple of hints, 
don't stay in any time period too long. 
You may find yourself sticking around 
longer than you had planned. The 
entire building that the time machine is 
in will go with you in time. With that in 
mind, everything you find can be stored 
in the building quite safely, The picture 
on the wall is worth checking out. 
TIME ZONE 

Time Zone looks to Pe an interesting 
program, aside from a couple of bugs. 



It seems that the 'Backup Program Disks' 
option in the main menu does not func- 
tion properly. Another bug lies in Tokyo 
in the year 2082 A.D. It seems that there 
is an error in the copy of the program 
that I viewed, However the possibility 
exists that the version (which I played 
the week it came out) that I have may 
just have been a lemon, I would be 
interested in any input concerning 
problems or just plain comments con- 
cerning the program in general, 

On the bright side, I found Time Zone 
to be an interesting prospect within the 
realm of adventuring, but only time (no 
pun intended] will determine whether 
or not the program justifies the S1©0 
(hak kaf) price tag. At any rate, here's a 
couple of clues: In London in 2082 A.D. 
it's a good idea to leave behind any- 
thing you are carrying by the time 
machine. After you have mapped out 
this section of the game, the effect of 
your actions will be very obvious, Be 
careful of what you are carrying. If you 
go into a time period that the particular 
item(s) cannot be carried due to tech- 
nological limitations, you will lose them! 



ULYSSES AND THE GOLDEN FLEECE 

Ulysses and the Golden Fleece has 
proved to be a fair challenge. Even 
though bribing public officials is gener- 
ally frowned upon, you won't get 
arrested for trying it. 
IS IT ADVENTURE? 

One issue I would like to touch on Is 
'how adventures should be classed' 
with respect to this column. With such 
programs as 'Castle Wolfenstien,' 
'Crush, Crumble and Chomp,' 'Dark For- 
est,' 'Ruski Duck' and the like, it is 
becoming more and more difficult to 
determine exactly what programs to 
cover in this column. To get to the point, 
what I need is some input from my read- 
ers. Give me an idea of what sort of soft- 
ware you would like to see covered. 
(Unless otherwise requested, your letter 
may be printed in the next issue of 
HARDCORE. 

In closing I would like to leave you 
with a little food for thought: 

TREBORSUX! 
Until next time, 

MikeFlynn 



APPLE 



201 - 839-3478 

Dealer and Distributor 
Inquiries Invited. 



THE PERFORMER PRINTER 
FORMATTER BOARDf or Ep$on, OK 
NEC 8023, CITOH 8510 provides 
resident screen dump and print format- 
ting in firmware- Plugs into Apple slot 
and easily accessed through PR# com- 
mand — Use with standard printer cards. 
$49.00 specify printer. 




APPLE 

333 



THE MIRROR FIRMWARE FOR NOVATION APPLE CAT l<-"> | 
The Data Communication Handler ROM Emulates syntax of 
another popular Apple Modem product with improvements. 
Plugs directly on Apple CAT II Board. Supports Videx and 
Smarterm 80 column cards, touch tone and rotary dial, remote 
terminal, voice toggle, easy printer access and much more. 
List $39.00 — introductory Price $29,00 



PARALLEL PRINTER CARD 




A Universal Centronics type 
parallel printer board com- 
plete with cable and connect- 
or. This unique board allows 
you to turn on and off the 
high bit so that you can access 
additional features in many 
printers. Use with EPSON, 
CITOH, ANADEX, STAR- 
WRITER, NEC, OKi and 
other with standard Centronics 
configuration. QQ 



201 - 839-3478 

I NIBBLES AWAY II 

/(GAIN ! Ahead of all others. 

(•AUTOLOAD PARAMETERS . . . Free's the user from 
having to Manually Key in Param values used with the 
more popular software packages available for the Apple II, 

| • EXPANDED USER MANUAL . . Incorporates new Tutorials 
for all levels of expertice; Beginners Flowchart for 'where 
do I begin 1 to 'Advanced Disk Analysis' is included. 

I' TRACK/SECTOR EDITOR ... An all new Track/Sector 
Editor, including the following features: Read, Write, 
Insert, Delete Search, and impressive Print capabilities! 

|* DISK DIAGNOSTICS . . . Checks such 

things as: Drive Speed, Diskette f^ ui a»a u *' y ' 

Media Reliability, and Erasing 

Diskettes. 

|« HIGHEST RATED. . .Best back up 
program in Softalk Poll [Rated 
8.25 out of 10). 

|» CONTINUAL UPDATES . . . Avail- 
able from Computer Applications RQ QR 
^dndrjc^Histing^or^h^omrce^^^^^^^^^^JjJjJJj 




DOUBLE DOS Plus 



DOUBLE DOS Plus — a piggy- 
back board that plugs into the 
disk-controller card so that 
you can switch select between 
DOS 3.2 and DOS 3.3 




$39 



DOUBLE DOS Plus requires APPLE DOS ROMS 



A SupEr Mail Us! Plus more up id 1000 Fmrics on Single 3.3 Disk (only 1 
Drive i-equiref.tr ? second access time to any name full sort riaprthiliiies 

Dual Index Mode? supiMwis new 9 digit Zip. Easy Hi lollow manual 
Ni.n Copy Protected 4 user defmed tables with: 26 sort ^luctions per table 

Beta MfS*ed <nr G months user defmerd label generation, 
INlHODLJCTOnY PRICF %}2G. S99.0D Dealer & Dist. IntiuinRS Invited. 

Super PIX 

The Software package that wilt allow your printer to dump page 1 or page 2 of 
the Apple Hires screen horizontally or uerlieally. Use with EPSON® MX-30 
with or without GRAFTRAX® Roms, MX-70 OKI® Microline BO, B2, 83. 
83A, B3A - C. ITOH<3 3510 and NEC 8023A. Requires Tymac Parallel 
Printer Board PPC-100, . . . $24.95 



HIRES SCREEN DUMP ♦♦■ 



THE APPLE CAM)— Two sided 100** plastic reference care 
Loaded with inlormahon ol interest 1o all Apple owners J3 98 




MICRO-WARE DIST. INC. 



r.o. aox ii3 
fomftoh puma a J. 
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Dealer and Distributor Inquiries Invited. 
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a new users 1 column 



Using VisiCalc For: Job Costing 



by Jerry Scott, PhD 

The VISICALC program from Personal 
Software is the constant leader in Apple 
business software sales. This writer feels 
that every Apple owner should have 
and use the VisiCalc program. Ten 
years programming experience has 
taught this author that in programming, 
It is 'a far better thing' to learn a few 
important things really well. For the 
Apple user, VisiCalc is a very important 
thing, 

I often tell beginning Apple owners to 
buy: 

1 . a Word Processor Program, 

2. VisiCalc, 

3. and a Data Base Program, 

and then spend the time necessary to 
learn how to use these programs well. 
Beginners should do this even before 
learning to program. It takes about a 
month or so for the dedicated user to 
learn to use these three programs. After 
that, he really has gained some power 
with his Apple. If his needs still aren't 
met, then he will definitely understand 
his real needs much better. Then he 
might begin programming, or contact 
an experienced programmer to begin 
the process of getting the necessary 
software written. 

4. a 3-day 

introduction 

This article will not attempt to fully 
teach someone who has never seen 
VisiCalc how to use it. Personal Software 
has provided a comprehensive 200 
page manual for that purpose. (The 
manual is hard to follow in some 
places, yet is truly excellent in others, It 
must be worked through to learn all the 
'ins and outs' of VisiCalc. Each of my 
columns will teach some important 
aspect of VisiCalc use. 

Most important actions in VisiCalc 
begin with a COMMAND. 

VisiCalc pioneered the 'type ahead 
buffer' for the Apple, and all com- 
mands begin with a slash ( / ]. This 
means that many commands can be 
strung together. For example: 

To globally format the screen so that 




M II J 1.1 .11 .' 'I - l J II I . 




Visicalc is a trademark of Visicorp 



all numeric entries are in 'dollars and 
cents 1 , simply type: 

/GFS 

The /G means "do something glob- 
ally." 

The F means 'format' 

And the S means 'use the dollar and 
cen+s' option of the Format command. 

This command has three levels, and 
VisiCalc uses 'dynamic prompting' at 
the top of the screen to tell its users 
exactly what is happening. 

Thus, the quickest way to learn Visi- 
Calc Is to experiment with all the com- 
mands. Most of them are nmemonic 
and are thus easy to remember: 

/P Print 
IS Storage 
/I Insert 
ID Delete 

Here is my standard advice for 
quickly learning VisiCalc: 



day 1 = FUNCTIONS 

Play with the commands for an hour 
or so, then get out the short reference 
guide [5 pages) and look at the FUNC- 
TIONS, 

These begin with the 'at' sign ( @ ) and 
are also mnemonic, 

@SSum 
@ P Product 
@ A Average 

With these experiences behind you, 
study the Command Reference Chart 
(3-3,3-4] in the manual. And make sure 
that you learn the /R Replicate com- 
mand the first night. This should end the 
first days work. 

day 2: EDITING 

On the second day you can read 
through several chapters of the 
manual, During that day, you should 
become familiar with the /E Edit com- 
mand. 

The /E command is one of the big 
improvements in the new 3.3 version. At 
the end of this study period, you should 
try building a simple four column appli- 
cation. 

I recommend: CHECKBOOK BALANC- 
ING 
Use these columns: 

1. CHECK* 

2. CHECK AMOUNT 

3. DEPOSIT AMOUNT 
A, BALANCE 

I still use a similar format to balance 
my checkbook at the start of each 
month. Onceyou are realty familiar with 
VisiCalc, such an application takes 
about 5 minutes to write, 

day 3' PRINTING 

Then on the third day, learn how to use 
the IP Print command, and how to 
spruce up the outputs of your work- 
sheet. 

The /- Repeat command is useful 
here. 

You should also learn to use the /W 
Window and the IT Title commands to 
help improve the way the screen looks 
during data entry 

After the third day, you should be able 
to do a compiicated balance sheet or 

continued 
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budget. Surely, you can impress your 
friends with your checkbook applica- 
tion and VisiCalc's recalculation. 

Once the program's commands are 
learned, it usually only take a few hours 
to set up balance sheets, budget 
charts, etc. The reference manual is still 
there, and the dynamic prompting and 
mnemonic nature of the commands 
make them easy to remember and use. 
These same balance sheets would take 
even an astute programmer several 
days to program in Applesoft and 
much longer to completely debug and 
verify. 

B. an estimation 

application 

Now I will outline how to use VisiCalc 
to do Job Costing. 

The VisiCalc worksheet has 254 rows 
and 63 columns. With only 64K of main 
memory, all of these can't be used at 
once. Experience has shown that at 
least 150 rows of 8 to 1 columns can be 
used. 

Most companies estimate how much 
the material for a job will cost by looking 
up items in catalogs and calculating 
cost estimates from them. Therefore, the 
first step In the Estimation Process is to 
load the catalog items into VisiCalc 
worksheets of about 150 items each, 

Each item must be complete with: 

1, Parts numbers 

2, Descriptions 

3, Costs 

Each item will occupy one row of the 
worksheet, Once the formulas for the 
first line are correct, use the /R Replicate 
command to put the same formulas on 
all the remaining 149 lines. Then SAVE 
the worksheet with a very clear and 
suggestive file name. Do the same 
again for each succeeding 150 items 
until done. Obviously, this approach will 
not work for someone with thousands of 
items or for someone whose items 
change daily Instead, this application 
works best for the estimator who has 
only about 500 to 1 000 relatively staple 
Items from which to choose. 

The individual lines containing the 
items are entered in such a way that all 
the job estimator has to do is to enter the 
number of each item he wants to order, 
ana the VisiCalc formulas will calculate 
the total price and other associated 
formulas for that item. Then the estima- 
tor uses the /M Move command to 
move each row with the item just orde- 
red to row 250. He does this for each 
item he orders in the first file. 

The /M Move command works per- 



fectly for this application. For example, 
If one whole row has been moved to 
line 250, moving another row to line 250 
causes the first moved row to be relo- 
cated to line 249 and the newly moved 
row to be at 250. Thus you never have to 
worry about displacing an important 
row. 

Once all the lines from the first file 
have been entered and moved, the 
second file is loaded using the /SL Load 
command, The /SL command loads a 
new file over the old in each position of 
the worksheet. Each position is thus 
what is in the new file in that position, 
except that If the new file entry is blank, 
then the old file entry is kept. In our 
example, our ordered entries have 
been moved above line 150, so they 
are unaffected by the loading of the 
new file. 

Instead, all that really happens is that 
the 150 original rows are replaced with 
the 150 rows from the second file. The 
action is Just like turning a page in a cat- 
alog, Then the whole process is 
repeated with the second file, and all 
other files until all Items have been 
ordered. 



XlisiCore? 



Print-Outs 



If the estimator is going to order more 
than 100 items, he must get print-outs 
with about 50 items on it. This is actually 
a better procedure since a normal 8 1/2 
by 1 1 page contains only 66 lines. The 
©SUM command can be entered 
when the screen is built, summing the 
line totals from lines 200 to 250. This 
command is simply: 

@SUM(C20E> . . . C25Q) 

where C is the column the line totals are 
In. Thus, the job estimator doesn't have 
to worry about how many items he has 
entered. If some of the lines from 200 to 
250 are blank, then the @SUM com- 
mand ignores them, 

The /P command can be used to print 
the rectangle of the worksheet which 
begins at line 200 and extends to line 
252. The first 199 rows won't Pe printed. 

Moving the items to line 250 thus 
serves two necessary purposes: 

1 . It gets the ordered items out of the 
way of the next file load, and 

2. It saves a lot of useless printing. 

The only way to print out odd num- 
bered rows is to do it one at a time or 
move them so they are continguous. 
The 'one at a time' method won't pre- 
serve totals, so we move the items. 
Besides this, the estimator only wants to 
print out the items he has oraered, not 
the entire catalog, and the company 
receiving the order only wants the 
same. 



(This same trick can be used to copy 
some 'protected' diskettes. Boot the 
protected disk, then get into the monitor 
and move the file into RAM unaffectea 
by a warm boot, Next do a warm boot, 
and then move the file bock and save it 
onto the nonprotected diskette. This is 
often quicker than going to cassette. 
Sorry for the digression, but since this is 
HARDCORE, I couldn't resist It!!) 

This estimation application illustrates 
the use of two useful commands, the /M 
Move command and the /SL Load com- 
mand. 



Problems 



Using VisiCalc for this application 
causes some problems, mostly In the 
data entry. A good typist has trouble 
keeping from overrunning the field 
widths, which the tl Edit command 
helps ease. 

The /R Replicate command makes 
the formulas very easy and quick to 
enter, 

And because of the recalculation 
ability of VisiCalc, changes are easy. 
This is very important to the estimator, as 
prices change often, Also, simple 
changes like a percentage increase in 
the cost of items, or a larger percent 
profit, can be easily accomplished with 
recalculation. All of these are important 
to the job estimator, since they will all 
happen in the future. 

The real benefit to the estimator Is that 
he doesn't have to worry about the cor- 
rectness of the arithmetic, and if 
changes are made (as they usually will 
be), new updates and print-outs are 
routine and easy. 



Conclusion 



This type of VisiCalc application will 
appeal to a small businessman who 
handles less than a thousand proaucts. 
VisiCalc costs about S200 and will do 
this application and many others like 
Checkbook balancing, small budgets 
and other calculations which a calcu- 
lator would do. Estimation programs 
can cost several thousand dollars, so 
this application using VisiCalc is very 
cost-effective, 

In future columns, I will present appli- 
cations which use other commands. 
Also, I will review some of the useful Visi- 
calc utilities, like VersaCalc, which 
makes VisiCalc even easier to use and 
even more useful, I would like to hear 
from readers about other uses being 
made of VisiCalc and will use the best 
of them in this column. 
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continued from page 37 

When the drive stops, Boot 2 will be in 
memory at page $03. Move the code 
at $300 to $9300. 

93AKK3O0.3FFM 

The exit from Boot 2 is via an indirect 
JMP at $9343. This JMP normally points 
Into itself. Rather than write any addi- 
tional code to check when this JMP is 
changed, allow the code at $300 to be 
called as a subroutine and change the 
Indirect JMP at $9343 to point to $9501 . 
This works because the JMP at $9343 is 
not seen until Boot 3 is completely 
loaded. 

Link Boot 1 to Boot 2 and run Boot 
again. 

9343:4C 01 95 N 9843:93 N 96006 

Boot 3 is now in memory Location 
$93CC holds the page minus 1 of the 
start of Boot 3. You should find a $B6 
there. That means that Boot 3 starts at 
page $B7 or SB700 In memory. This is the 
final Boot, This stage will load the main 
program. 

Boot 3 is large and would be cumber- 
some to modify if moved. It can be left 
right where it's at and the Boot 2 code 
can be changed so that next time it will 
load in a different location. The page 
number that Boot 2 uses when it loads 
Boot 3 from page $B6 to page $D6 will 
be changed. 

9313:A9 D6 EA 

This wifl cause Boot 2 to try to load the 
Boot 3 code into the space occupied 
by the monitor. Since the monitor is in 
ROM (Read Only Memory), nothing will 
change and the Boot 3 code at $B700 is 
protected, 

At $B749 is a routine that garbages 
the Boot 3 code after it loads in the pro- 
gram. 

At SB759 is a JMP to $600. This is the 
actual start of the program. Since $600 
is in the text page, the boot with the 
code can't just be stopped at $9501 , If 
this was done, the code on the text 
page would scroll or be over-written. 
The code needs to be moved up to 
some safe place in memory. Also, The 
end of the program Is at $A000 [my 
guess), which is the same place that 
DOS resides on a normal disk. 

The Galaxian Logo is on HIRES page 1 
(S2000-3FFF). It is a reasonable assump- 
tion that this is a safe place where no 
code exists. The logo will be lost, but the 
memory Is needed. 

The following code is a routine that 
compresses memory by moving page 
$00 thru page $08 up to page $20, and 
moving page $40 thru page $9F down 
to page $29. 



SOFTKEY4' 



B0001A2 00 BD 00 40 9D 00 29 
B008:E6 00 F7 EE 04 80 EE 07 
B810:B0 AD 04 B0 C9 A0 90 EA 
BB18:A2 00 BD it 00 9D 00 20 
B020:E8 D0 F7 EE 1C B0 EE IF 
S023;B0 AD IE B0 C<? 09 90 EA 
B030MC 59 FF 
B000.B032 

After entering the code, link Boot 3 to 
it and link Boot 2 to Boot 3. 
B749:4C 00 BO N 9343:4C 00 B7 

Check to see that all the changes are 
correct, then run Boot 0. When the drive 
stops you should see a lot of inverse and 
flashing characters on the screen. This is 
the portion of the program that is 
loaded into the text screen area. An 
image of this code is safely stored at 
$2000. 

Remove the back-up copy of Apple 
Galaxian and insert the 48K slave disk in 
the drive. Boot the disk, then enter the 
monitor. There are a few more changes 
to make before the file can be BSAVEd. 

The binary program that you are 
going to save is 132 sectors long. DOS 
will not normally allow you to save a file 
this long, so change the range limita- 
tion in DOS from 32K to 64K. 

A964:FF 

When the slave DOS was Booted, it 
over-wrote the code on page $08. An 
image ot the page $08 code was 
saved at $2800. Move this code down 
to page $08. 

S00<2800.28FFM 

Now all that is left is to enter the rou- 
tine that will move the program back to 
where it will run. This routine also discon- 
nects DOS and selects the hi-res screen 
before it JMPs to $600. 



2880:A2 00 BD 00 80 <?D 00 9F 


2808:E8 00 F7 CE 04 28 CE 07 


2810:28 AD 04 2B C9 29 B0 EA 


281B1BD 00 20 95 00 BD 00 21 


2820:9D 00 0! BD 00 22 90 00 


2828:02 BD 00 23 90 00 03 BD 


2330:00 24 90 00 04 BD 00 25 


2B38;9D 00 05 BD 00 26 90 00 


2940:06 BD 00 27 90 00 07 E8 


2848:00 CE 20 89 FE 20 93 FE 


2S58IAD 50 C0 AD 57 C0 AD 52 


2B58:C0 4C 00 06 



Add a JMP at $7FD to the move rou- 
tine, and you are ready to BSAVE the 
file, 

7FD:4C 00 28 

BSAVE GALAXIAN, A$7FD, LS6103 

Now that it is safety stored on the disk, 
you can run it and discover how much 
of the memory that was saved is really 
used, More often than not, all of mem- 
ory is not used. A large part of what was 
saved is not reguired by the program. 
BLOADing the file and erasing pages 
before you run the program is the sim- 
plest way to determine what sectors are 



necessary. You could determine if there 
Is sufficient memory that is not used and 
retrace the Boot code in order to save 
the HIRES picture. This is a fine point that 
is not required and is left up to the 
reader. 



= LOB. ===== 
continued from page 37 

» restore norsal DOS values « 
90 POKE 47445,213 ! POKE 47455,170 S 
POKE 47466,150 : POKE 47335,213 : 
POKE 47345,170 : POKE 47354,173 : 
RETURN 

» get original disk « 
100 At = 

"INSERT 0RISINAL DISK IN DRIVE 1." 
: S0SU8 40 

» read sector zero << 

110 CO = RO ! DV = 1 : 60SUB 50 : CALL 
10 

» reset JOB variables for JNIT << 

120 VL = PEEK IQVU : DV = 2 : CD = IN 
: SOSUB 50 

» INITialsze destination disk « 
130 At « 

"INSERT BLANK DISK IN DRIVE 2. • : 
60SUB 40 : CALL 10 : VL - 

» CONTROLLER portion of progra* <( 

1000 FOR TK = 3 TO 34 

1010 DV = 1 : CD = RD : G0SUB 50 : 

SOSUB 60 : SOSUB 60 
1020 DV = 2 : CD * HR : 80SUB 50 : 

63SUB 90 : SOSUB B0 
1030 NEXT 

» end routine << 

62990 At * 'COPY COMPLETED" : G0SUB 40 
: END 

>> poke lachine subroutine \\ 

63000 FOR K « 768 TO 796 : READ A ! 

POKE X A ; NEST 
63010 DATA 169,3.160.8.32,217.3.96,1.96 

,1,0,0,0,25,3,0,32,0,0,1,0,0,94,1 
,0,1,239,216 

>> initialize variables << 

63020 TK * ST = VL = CD = DV 

63030 TRK = 780 : SCT « 781 : CND =■ 786 
: RD - 1 : Nfi * 2 : SLT - 777 : 
DRV « 778 I BttF * 785 ! ERR = 789 
: VOL * 779 : 10 = 768 : HIT = 
4 : 0VL * 790 

63035 DOS = 15 

63040 RETURN 

>> address and data lark information << 
63050 DATA 
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As copy-protection schemes have 
changed and improved, so have bit- 
copiers. Most bit-copiers hove several 
updated versions, and the list of param- 
eters for each copy program is long. 

Because protection methods change 
so rapidly, it would be useless to rate bit- 
copiers according to which copier is 
able to duplicate a certain program , By 
the time this article reached print, it 
wouldn't be accurate. 

Instead, the bit-copiers have been 



reviewed on the basis of their docu- 
mentation, ease of use, and versatility. 

Documentation is the most important 
part of a bit-copy program. It must be 
clear and understandable, yet give 
complete instruction on how to use the 
program. It should also go into detail 
about the use of parameters,showing 
how to determine which ones are suit- 
able. 

Ease of use is a rating based on both 
how obvious the screen prompts are 



and how many keystrokes are neces- 
sary to achieve a desired result. Screen 
format is also taken into consideration. 
Versatility is reviewed on the basis of 
what a bit-copier will do aside from 
copying a disk (it has nothing to do with 
the number of parameters that a partic- 
ular program may use). It Is an Impor- 
tant factor in how useful a bit-copier will 
actually be, depending on individual 
purposes, and may contribute to how 
easy the program is to use. 



Review of the "New" Bit Copy Programs 



Locksmith 4.1 



Locksmith 4.1 comes with an 11-page 
booklet which contains explanations of 
its use and features, and a simple 
description of copy-protection meth- 
ods. Generally, it is assumed that the 
reader has a basic knowledge of com- 
puter operating procedures and termi- 
nology. Each program function is 
clearly explained, but the text would 
benefit from additional diagrams and 
examples, 

A separate list of parameter values 
and their definitions is supplied with the 
manual, but no attempt is made to 
show how to determine which parame- 
ter should be changed for a particular 
disk format, Parameters are changed 
by typing the parameter number from 
the list, and then entering the desired 
value. 

Locksmith 4.1 has a screen format 
that is easy to understand. A single key- 
stroke is sufficient to respond to most of 
the displayed instructions, and it is usu- 
ally not necessary to press "return." 

During a disk copy, a great deal of 
information is displayed on the screen. 
Some of it is not explained, however, 
and is therefore useless, As new infor- 
mation enters the screen, older infor- 
mation scrolls off. A routine is included 
that will print the status display, allowing 
a permanent record of the track copy 
of each disk to be saved. 

Locksmith 4. 1 comes with a full nibble 
editor. It is possible to read, edit, and 
write complete tracks with a process 
that is simple and straightforward. The 
internal analyze routines can be used, 
but the procedure is more involved, 

Other program features include a fast 
disk erase, disk certify, and a disk speed 
test. 

It is explained in the manual that 
Locksmith 4, 1 will work with another pro- 
gram called "The Inspector," which 
must be purchased separately. This pro- 



gram can save parameter changes, 
and read and write sectors from a 1 3 or 
16 sector disk. 'The Inspector" was not 
evaluated, since it was not included 
with the 4.1 disk, 



Nibbles Away H 

The Nibbles Away It bit-copier is docu- 
mented with a 40-page booklet which 
provides detailed information on all of 
its functions. The use of tables and dia- 
grams contributes to the relatively good 
quality of the text, 

A special beginners appendix gives 
a brief introduction to copy-protection, 
and explains what steps to take when 
the default values are inadeguate for 
copying a particular disk. Another 
appendix for advanced users 
describes protected disk formats and 
discusses parameters. An appendix on 
nibble counting is also included. 

Nibbles Away II screen prompts are 
easy to understand, They are displayed 
in a single menu along with their corres- 
ponding default values, which enables 
viewing of all the information at once. If 
the default values are used for a copy, it 
takes only a single keystroke to start the 
program. 

The system modifier is responsible for 
parameter changes, and may be 
entered into by typing "fvf' from the 
master menu, Another menu of param- 
eters appears, from which the set to be 
changed is selected. This set is then dis- 
played along with the parameter 



Parameters for Locksmith and 
Nibbles Away have been included in 
this issue along with their 
explanations and uses. Parameters 
for Back it up n will probably be in 
the Update or following issue (as 
soon as we convert the files and get 
more detailed explanations on their 
uses).— EDITOR 



names and their current values in a 
menu that is both convenient and easy 
to use. 

The Track/Bit Editor (TBE) fe a normal 
DOS editor. A sector from a 1 3 or 1 6 sec- 
tor disk can be read. Changes can be 
made to the sector data in memory, 
and the sector can be written back to 
the disk. This is required to copy some 
disks. 

The exec files included with Nibbles 
Away II are a unique feature. These are 
files that make automatic changes to 
the parameters in memory so that a 
particular disk can be copied more 
easily. Mot all of the exec files proved 
accurate. Some files loaded properly, 
but the disk did not copy, 

A special filing system allows param- 
eter changes to be saved on a data 
disk created with the program, so that 
the next time a particular disk is 
bocked-up it is only necessary to load 
the appropriate parameter file, 

A disk diagnostic utility is also 
included on Nibbles Away II that will 
erase a disk, check a blank disk for 
flaws, and test drive speeds. 

Back It Up ][+ 

Back It Up II+ is accompanied by a 
14-page manual that is detailed 
enough to be a decent guide for some- 
one who is new to the bit-copying proc- 
ess. It gives a good description of the 
functions of a nibble copier, and the 
step-by-step directions are aided by 
examples. A section on copy- 
protection is also included, 

As far as parameters are concerned, 
the text gives little in-depth information. 
An attempt is made to explain how to 
use selected individual parameters, 
but it falls short from lack of hard exam- 
ples. The manual lists parameter values 
with brief definitions in an appendix, 
and a section on "Advanced Tech- 
niques" contains instructions on chang- 
ing parameters. 
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The process of changing parameters 
is fairly simple. A "/" is entered in 
response to any question from the 
screen display. Then the program will 
ask which "parrn*" should be changed 
and what 'Value:" is desired. 

The Back It Up 11 + screen prompts are 
clear and understandable. The exten- 
sive use of default answers make hitting 
the "return" key the only response that is 
usually needed. 

While the copy is being made, single 
letters are used to follow the track copy 
status. At this time the screen display is 
rather lifeless, as there is just one point 
changing at a given moment, but set- 
ting parm SEC to 5F0 helps by causing 
the program to display more informa- 
tion. 

A nibbler is included with Back It Up 
11+ as an aid in finding the proper 
parameter values. By pressing the "R" 
key in response to any screen prompt, 
the program goes into the "Track Exami- 
nation Mode." The number of the track 
to be studied can then be entered 

This is a "read only nibbler," and does 
not allow editing and writing to the disk. 



Closing Remarks: 

Out of the three bit-copiers reviewed, 
Nibbles Away II has the most complete 
documentation. Although more step- 
by-step directions could have been 
used in describing the process of sim- 
ple copying, the material given is the 
most detailed and informative. 

As for screen prompts, Nibbles Awayll 
has an advantage over the other two 
programs because all the information Is 
displayed at once. Back It Up 11+ and 
Locksmith 4.1 allow most prompts to 
scroll off the screen after a response is 
given, This method is simpler in appear- 
ance than the Nibbles Away II menu of 
prompts, but the latter takes little get- 
ting used to and has far more benefits. 

During the copying process. Lock- 
smith 4.1 has an active screen display 
that provides the most information. The 
Back It Up II display is easier to under- 
stand, but more static. Nibbles Away II 
has a screen display that is equally 
easy to understand and very lively. It will 
print "READING" or "ANALYZING," rather 
than just the letter "R" or "A," The pro- 



gram will beep when the copy is fin- 
ished. 

Nibbles Away II has many more fea- 
tures than either of the other bit-copiers. 
The auto-load or exec files make copy- 
ing some disks very easy. This copier 
may also be booted from any slot, while 
Locksmith 4.1 and Back It Up II + must be 
booted from slot 6. The system filer is a 
real advantage to someone who 
doesn't use bit-copiers often and may 
forget how to use the parameters [they 
can be stored on the special data disk 
for future use). 

As a final note on parameters, 
detailed Instructions on their use can 
be found on "The Source," a telecom- 
munications network accessible by 
MODEM. However, only paid sub- 
scribers can use the network. (Reprints 
of these articles can be found else- 
where in this issue,] It would be more 
convenient if complete parameter 
instructions were supplied with the bit- 
copy programs. 
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Why you need Locksmith. 

^fou've invested some money and a lot of time in a 

M. ci 



, commercial software program foryour^>ple.Itivorks 
well, to the point that you are dependent on its day-to-day 
functioning. But the disks are copy-protected. So you are 
also dependent on the vendor's back-up (if furnished) , on 
his living up to vague promises of support, even on his 
ability to stay in business. 



N: 



o computer user can live with that. So until die 
situation changes (and it will) , you need Locksmith. 

Iocksmith (new 4.0 version) will copy almost all 
I "protected" diskettes for the Apple. It is the most reliable 
nibble-copy program you can buy. Locksmith is suitable 
only for backups, because the copies 
include all serial numbers, codes 
and protection features of the 
original (under the new copyright 
law, you'd have to be pretty 
foolish to try bootlegging 



o 



software that is traceable back to (he purchaser) . 

Iocksmith includes nine other utilities, of which these 
J five are vital to the integrity of your system: 1. Media 
surface check — Never commit data to a Sawed diskette 
again. 2. Disk-drive speed calibration— the most frequent 
cause of communication bugs between Apples, 3- Degauss 
and Erase — Make sure no stray data is left over, 4. 
Nibble-Editor — sophisticated read/write tool for repairing 
blown disks. 5, Quickscan —Check for unreliable data, find 
used and unused tracks. 

All for just $99-95 at your local dealer or direct. You 
i don't just need Locksmith. You can't afford to be without 
it. Mastercard and Visa 
holders order toll-free, 
1-800-835-2246. 
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NIBBLES AWAY II 



SIMPLY THE FINEST BIT COPIER EVER CREATED!) 



Nibbles Away II provides a means to 
protect your software investment by allowing 
you to make additional copies (back-ups) of 
almost all Apple "protected" diskettes. 

Nibbles Away II is user orientated; 
included are tutorials for all levels of 
expertise, beginners flowchart for "Where Do 
I Begin" to "advanced disk analysis." Nibbles 
Away II is the ultimate bit copier for the 
Apple. 

ONLY $64*95 
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LOCKSMITH PARAMETERS 



This document describes all user- 
changeabte Locksmith parameters in 
depth, A partial list of these parameters 
was previously distributed to all version 
4.0/4.1 owners. Also provided here is 
detailed Locksmith program logic Infor- 
mation. 

Note— this document is of o highly 
technical nature, and is intended pri- 
marily for the advanced user of Lock- 
smith. 

BACKGROUND 

When Locksmith was first introduced 
in January 1981, It would copy almost 
all disks with no special instructions from 
the user. Only a few disks required 
parameter changes. Alas, those good 
old days are gone forever, Instead of 
providing the user with better backup 
policy, software vendors decided to 
escalate the battle by developing 
more complicated (and in some cases, 
bizarre) protection techniques. 
Because of the many different tech- 
niques now In use, it Is likely that many 
disks will require some input from the 
user in the form of parameter changes. 

Omega Microware currently main- 
tains an extensive list of software, along 
with the Locksmith parameters used to 
copy each. Some of the entries on this 
list are user-supplied. Omega Micro- 
ware welcomes information from users 
regarding how to back-up software not 
already on this list, 

OVERVIEW 

Locksmith copies disks by reading a 
track, performing analysis on the data, 
and writing the track to the copy disk. 
Reading and writing are fairly straight- 
forward functions. 

The analysis of the track data is by far 
the most difficult task, and must provide 
for flexibility. Many analysis routines 
(algorithms) are provided within Lock- 
smith, Each algorithm performs a spe- 
cific function relating to the analysis of 
track data. By changing parameters, 
the user may select, disable, or change 
the execution order of algorithms, 
Parameters may also be used to define 
values to be used by individual 
algorithms, 

ALGORITHMS 

The algorithms are numbered from 
to S23 (all values are in hex). New 
algorithms may be added in future ver- 
sions of Locksmith. During track analy- 
sis, algorithms are selected sequentially 




from a table of algorithm numbers, 
located from PARM 4C-80. As 
algorithms ore selected from this table 
during analysis, they are displayed on 
the screen as 2-digit hex numbers in 
Inverse video. 

Algorithm 00 indicates a null 
algorithm, which con be used to 
replace algorithm numbers in the table 
which the user wants to disable, An FF 
entry in this table indicates the end of 
the algorithms to perform , 

Currently, the algorithm table con- 
tains four separate algorithm 
sequences, each one terminated by an 
FF entry, The starting point of the 
algorithm sequence to be used is 
defined by PARM 25. This parameter 
contains the index into the algorithm 
table to be used as the first algorithm of 
o sequence. For example, if PARM 25 = 
00, the algorithm sequence would start 
at PARM 4C. If PARM 25 = 10, the 
algorithm sequence would start at 
PARM 5C. The section of algorithm table 
starting at FARM 71 is selected as an 
algorithm sequence start (instead of 
PARM 4C) when synchronized tracks are 
chosen. 



Algorithms, in addition to performing 
their specialized function, can return a 
flag to indicate success or failure, It is 
possible to indicate that an algorithm is 
to be performed only if the previous 
algorithm failed. This may be done by 
setting the high-order bit of the 
algorithm number within the algorithm 
table. For example, an entry of A1 Indi- 
cates that algorithm 21 is to be per- 
formed only if the previous algorithm 
failed. 

Description of Algorithms 

The following is a list of algorithm num- 
bers and the parameters which affect 
them. 

ALG 00 (This algorithm doesn't do 
much of anything) 

ALG 01 (Consecutive nibbles to self- 
sync) changes normal nibbles to self- 
sync nibbles based on: finding (PARM 
10) consecutive nibbles in the range 
(PARM 34) to (PARM 35), inclusive. For 
example, if PARM 10 = 0C, PARM 34 = 
FE, and PARM 35 = FF, then algorithm 01 
would search for sequences of length 
0C nibbles with values FE through FF, 
and set them to self-sync, 

ALG 02 (Invalids to seif-sync) sets 
Invalid nibbles (those with 3 or more 
consecutive zero bits) to self -sync. 

ALG 03 (Standardize self-sync) sets all 
self-sync to (PARM 33], which must have 
high-order bit clear. 

ALG 04 (Loner self-sync to normal) set 
consecutive self -sync strings of less than 
or equal to (PARM 3C) to normal. 

ALG 05 (Glitch remover) set consecu- 
tive norma! nibbles of length less than or 
equal to (PARM 1 2) to self-sync. 

ALG 06 (Set self-sync by marker pat- 
tern match) searches for pattern speci- 
fied by (PARM 44-4B), and sets the 
previous (PARM 40) nibbles to self-sync. 
Values of 00 within the pattern ore 
"don't care" and always match. 

ALG 07 (Extend bit shifted self-sync) 
extends self-sync strings backwards, 
using the table at (PARM 86-A5). This 
table contains nibble value sequences 
frequently found to be self-sync. 

ALG 08 (Reserved for future use) 

ALG 09 (Trackstart after longest gap) 
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set trackstart to first normal after longest 
string of self -sync (gap), 

ALG 0A (Minimum length self-sync) 
extend self-sync strings backwards to 
minimum length of [PARM 2C). 

ALG OB (Set self-sync by self-sync pat- 
tern match) set self-sync based on 
multiple-byte pattern match. Pattern is 
defined at (PARM 81-85] and is termi- 
nated with a 00 value. 

ALG 0C (Shorten all gaps) shorten all 
gaps (consecutive strings of self-sync) 
by (PARM 41) nibbles if the string length 
was greater than or equal to (PARM 16). 

ALG 0D (2 of 3 gap merge) merges 
first and second gaps (by setting to self- 
sync, nibbles between them) if 3 gaps 
are found within (PARM 26] nibbles, (The 
gaps merged are usually the gap after 
a data field.) 

ALG 0E (Trackstart after first self-sync) 
sets trackstart to first normal after the first 
string of self-sync. 



ALG OF (Shorten longest gaps) shorten 
the longest gap if longer than (PARM 
2C) by (PARM XX) nibbles, Repeat this 
procedure (PARM YY) times, XX = 27 (or 
29 if synchronized) YY = 28 (or 2A if syn- 
chronized) 

ALG 1 (Reserved for future use) 

ALG 1 1 (Set failure flag) same as 
algorithm 00, but sets the failure flag. 

ALG 12 (Trackstart by marker pattern 
match] set trackstart to the first 
sequence to match pattern at (PARM 
44-4B),(seeALG06] 

ALG 13 (Center of gaps to normal) 
leaving 8 self-sync at the start and at the 
end of a gap, set self-sync in the center 
of the gap to normal. 

ALG 14 (Bit-translate to self-sync) using 
the bit table at (PARM D9-E8), translate 
nibbles corresponding to a one-bit to 
self-sync, Bits in the table represent val- 
ues for nibbles in the following order: 
80,81,82 FC.FD.FE.FF 



ALG 1 5 (Reserved for future use) 
ALG 1 6 (Reserved for future use] 

ALG 17 (Track-end and compare] this 
algorithm searches for a repeat of the 
track-start beginning at (PARM 1D) 
pages beyond the current track-start. A 
repeat of the track-start is determined 
by matching (PARM 1E] number of nib- 
bles. If the track size is greater than 
(PARM 1 B) pages, an error 2 status code 
will be issued. 

Once a track-end is chosen, the first 
two track images are compared, nib- 
ble for nibble. If an unequal nibble 
compare occurs, a look-ahead of up to 
(PARM 13) nibbles is performed, looking 
for self-sync, 

If self-sync is found, the compare fail- 
ure is ignored. If no self-sync is found 
during this look-ahead, a counter is 
incremented for the compare-failure, 
and this count is checked against 
(PARM 14), which must not be 
exceeded, or an error 4 status code is 
issued immediately 



Why do unnecessary surgery 
on your Apple? 



Sooner or later, you're going to need a 16K 
memory-expansion for your Apple. When you 
do, we suggest you buy it on the card that doesn't 
require poking about on the motherboard — nor 
removing a RAM chip, installing a strap, etc. 

The Ramex 16 RAM Board just plugs in. It's 
simple, reliable, and does its own memory 
refresh, with no additional connections. 



Run Pascal, Fortran, FP, INT and 
.other alternate languages, 56K 
CPM with a Z80 Softcard, increase 
usable memory for Visicalc by 16K, 
The possibilities are endless. Do 
it with the finest, closed-track 
engraved, epoxy sealed, 16K 



Apple and AppNiMifi sn: ftgsfc^ed trademarks of Apple 
C-OfliTJiflter, Inc. Pascal is a registered cradeiiLark yFilie Keeents of 
the L ofC. San Diego. Vislcaff: is a rurjstered trademark of 
Persona! Snfivt^n: CPM is a registered trademark of Digital 
Bestardl, Inc. ZHU is a registered trademark or ftlus, [nc 
Softcard Is a registered uatlrrmrk oF Microsoft.. 




board available — the Ramex 16. And do 
it without unnecessary surgery on your Apple. 

In spite of its quality, the Ramex 16 costs less 
than most other expansion boards— just 
$139-95- And it comes with a one year limited 
warranty, instead of the usual 90 days. 

et the Ramex 16 from your local dealer, 
or order direct. Visa and Mastercard 
holders call toll-free, 1-800-835-2246. 

QAAEGA MICROVWU*E,INC 

222 SO. RIVERSIDE PLAZA 

CHICAGO, IL 60606 

312-648-1944 



^ look, ma, 
no straps! 
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The 3rd track image is then used as a 
tie-breaker to determine which of the 
1st or 2nd track images is correct, The 
exact position in the 3rd track image is 
found by first finding the approximate 
tocation in the 3rd image (by using 
track length), backing up (PARM 1 1) nib- 
bles, and pattern-matching (PARM 32) 
number of nibbles, while searching 
through the next (PARM 31) number of 
nibbles. The 1st image is corrected by 
the tie-breaker nibble. This algorithm 
returns a success/fail flag. 

ALG 18-1F (PARM modifier) these 
algorithms are used to dynamically 
modify PARMs. The table at (PARM B6- 
D8) consists of several sequences of 
PARM modifier entries. Each PARM mod- 
ifier entry consists of a pair of bytes. The 
1st byte defines the PARM number, and 
the 2nd byte defines the new PARM 
value. The end of a sequence is indi- 
cated by a 0© entry for PARM number. 
and a new sequence begins with the 
next byte. Algorithm 18 invokes the 1st 
sequence of parameter modifier 
entries, algorithm 19 invokes the 2nd 
sequence, etc. Using these algorithms, 
parameters may be automatically 
changed and restored during anaiysis. 
The defaults for these algorithms are 
currently set as follows: 

ALG 1 8 Sets 1 3-sector PARMs. 

ALG 19 Sets 16-sector PARMs. 

ALG 1A Sets misc. PARMs. 

ALG IBSets nibble-counting PARMs. 

ALG 2® (Go to Nibble Buffer address) 
This algorithm is used in conjunction 
with the Nibble Editor. It prompts the 
user for an address to go to, and the 
Nibble Editor cursor is immediately 
placed at that location. (See: Invoking 
Algorithms from the Nibble Editor) 

ALG 21 (Set error code 1) issues an 
error 1 status code. It is usually placed in 
the algorithm table with the high-order 
bit set, to cause it to execute only when 
the previous algorithm fails. 

ALG 22 (Backup trackstart to front of 
gap) moves the trackstart pointer back- 
wards to the beginning of the preced- 
ing gap. 

ALG 23 (Set trackstart to longest nor- 
mal) sets trackstart to the 1st nibble of 
the longest sequence of normal nib- 
bles. 

Printer Control PARMs 

(Parm 2D) specifies the printer slot, 
and (PARM 2E) Is set to 00 If Locksmith is 
not to generate > CR < at the end of a 
line, or left at 01 if >CR<'s are to be 
generated. 



Maximum Error Count PARMs 

(Parm ©1)„(PARM 02), and (PARM 04) 
are used to specify the number of errors 
allowed for error codes 1,2, and 4 in 
automatic error retry mode. If incre- 
ments of 1/2 tracks are used, (PARM 
®9),(PARM ©A), and [PARM 0C) are used 
instead, 

Nibble-Counting PARMs 

There are 3 parameters which are 
used when nibble-count preservation is 
desired. Setting (PARM 36) to 01 turns on 
nibble-counting. The nibble-count toler- 
ance value, (PARM 37). specifies how 
close to the original disk the copy must 
be. When nibble-counting, the track- 
end pointer is moved up by (PARM E9) 
pages Pefore writing, 

Parms Used for Synchronizing 

(Parm 22) specifies the track * 2 to sync 
to. This is normally 00, but may be set to 
any track. (Parm 1F) is the length of the 
nibble sequence to sync with, and 
(PARM A6-B5) contain the pattern to 
match when attempting to sync on the 
sync-track. Values of 0© within the pat- 
tern are "don't care" and always 
match. (PARM 23) and (PARM 24) are 
values which can be used to adjust the 
accuracy of the sync-track routine, They 
are normally equal, and can be 
adjusted by increasing the value of one 
with respect to the other 



Note: Nibble count adjustment from 
software (using ">' and '<') will not 
work if a type-ahead buffer is installed 
on the Apple, lb perform nibble count 
preservation, either remove the type- 
ahead buffer, or adjust the disk speed 
pot directly. 

When the Nibble-Editor is entered 
from the main menu, the track is read 
into the buffer with no Locksmith analy- 
sis whatsoever. No nibbles will be indi- 
cated as self-sync [inverse), as this is 
determined when analysis occurs dur- 
ing a disk copy operation. Also, CTRL-B 
and CTRL-E will only place the cursor at 
the beginning and end of the buffer, 
because track-start and track-end are 
also determined by analysis during disk 
copy 

To enter the Nibble-Editor after analy- 
sis by Locksmith, perform a copy opera- 
tion, specifying manual error retry. 
Open the door of the copy disk drive to 
cause a verify error (error code 8) and 
enter the nibble editor by selecting: 

5. NIBBLE-EDIT CURRENT TRACK DATA, 

In this way a track may be nibble- 
edited after Locksmith has performed 
analysis on it. 



Parms Used to Control Writing 

(Parm 2®) contains the lead-in self- 
sync nibble value. (Parm 2F-30) (default 
is S1A00) number of these lead-in seff 
sync nibbles are written before track 
data is written, with the exception of syn- 
chronized track writing, which is pre- 
ceded by (PARM 23) lead-In self-sync 
nibbles, The number of framing bits (1 or 
2) is contained In (PARM 21), This places 
the proper number of trailing zero-bits 
after self sync, (Parm 2B) contains the 
number of the algorithm to be used to 
shorten the track after an over-write Is 
detected by verify readback failure. 
Other PARMs 

(Parm 38) is the number of nibbles to 
test during verify readback, (Parm 39), if 
set non-zero, shows the hi-res screen 
during analysis, to provide a graphical 
representation of analysis. (Parm 3A) Is 
used during disk certify. It specifies the 
maximum size of the track-end glitch. 
(Parm 3B), when set to 01, causes the 
Nibble-Editor to be entered for every 
track, before analysis. 

Debug Parameter 

(PARM ©0) is a special parameter 
intended for use during Locksmith 
debugging. When this PARM is set to 11, 
certain debugging options are 
enabled. They are: 

1 . Inspector entry is allowed even with 
no resident RWTS. 

2. Nibble-Editor is entered without 
prompting the user for track to read. 
This allows the previous track to be 
examined. 

3. Invoking algorithms from the 
Nibble-Editor. 

Invoking Algorithms from Nibble- 
Editor 

With debug PARM set (PARM 0© = 1 1 ), 
the Nibble-Editor is sensitive to two addi- 
tional commands. These are control-S 
and control-A. Control-S invokes Lock- 
smith track-analysis for the track cur- 
rently in the Nibble Buffer. Control-A first 
allows the user to change parameters 
by entering the parameter modifier, 
and after the user has indicated the 
end of parameter changes with a 
> CR < , it prompts the user for algorithm 
number. 

The user-entered algorithm number is 
executed immediately, and control Is 
returned to the Nibble-Editor. In this way, 
the user can dynamically test the 
effects of specific Locksmith algorithm 
sequences when attempting to copy 
unknown disks. Algorithm 00 can be 
specified if no processing is to be done, 
Algorithm 20 is very useful within the Nib- 
ble Editor to rapidly go to a specific 
address within the Nibble Buffer, 



HARDCORE COMPUTING 3.© 



P.O. BOX 44549 TACOMA, WA 98444 



PAGE 59 



List of IS PARAMETERS 



Maintaining an extensive and 
detailed list of disks which Locksmith will 
copy, as well as any parameter 
changes or patches which the user 
must make to copy certain disks Is a 
gargantuan task. 

Omega Microware is working hard to 
provide users with necessary PARM 
changes as they determine them. They 
openly solicit user input regarding Lock- 
smith parameters which work for cer- 
tain disks. 

Uncopyable? 

If the recommended parameter 
changes are made and the disk still 
won't copy, follow these Instructions: 

1 . Make sure the disk drive speed is 
correct. 

2. Retry the copy, reversing the order 
of the disk drives used. 

3. if possible, attempt the copy on a 
different Apple or set of drives to make 
sure that the problem is not that partic- 
ular set of disk drives. 

4. If all fails, write Omega Microware 
about the problem including all perti- 
nent information about what attempts 
were made to copy the disk. 

Counting 
Every Nibble... 

Some protected disks use a tech- 
nique known as nibble counting. This 
technique Is based on the fact that oil 
Apple disk drives run at slightly different 
speeds, and even the speed of a spe- 
cific disk drive varies slightly over time. 
Disks which are protected by this 
method count the nibbles on a given 
track and record this unique number 
somewhere else on the disk. When the 
disk is booted by the user, the nibble 
count on the track in question is 
checked against the correct value. 
Simply copying the track will almost 
always write a different number of nib- 
bles due to disk drive speed variation. 

Locksmith 4,0 has o provision for nib- 
ble counting, and will preserve nibble 
counts on any track requested, To 
request nibble count preservation, set 
PARM 36 to 01. (This is automatically 
done for the user when PARM 4C is set to 
1 B.) After the track is written to the copy 
disk, the nibbles are counted and com- 
pared to the original count to be pre- 
served. The difference is shown as a 
four-digit hex number preceded by '>' 
or ' < ' to indicate to the user which way 
to manually adjust the count, The count 



may be adjusted in one of two ways. 
Either the disk speed adjustment pot 
can be turned in the direction indi- 
cated by the ' > ' or ' < ' arrows (see user 
manual regarding disk speed adjust- 
ment), or a limited amount of adjust- 
ment can be done from software 
without actually adjusting the disk 
speed. 

To adjust the nibble count from soft- 
ware, press either '>' or '<' as indi- 
cated, and wait untl! the speaker 
begins beeping, The speaker will beep 
rapidly once for each nibble that the 
track is being shortened or lengthened. 
Then press the return key (or any key 
other than '>' and '<') and allow the 
nibble count routine to test the track 
again, When the nibble count is within 
the tolerance value specifiea by PARM 
37 [normally 00), the track will be con- 
sidered copied correctly. This tech- 
nique may seem cumbersome, but It Is 
the only way in which a track may be 
copied while preserving the nibble 
count. 

SOURCE FILE TV H0)TCA640>LS. PARAMETERS) 
SYMBOL MEANING 



T » Tracks to copy. 

S * Use syncronized copy. 

... » PARM5 to be changed before 

copying tracks indicated. 
BY ■ Shows track increment (By 1 if 

not otherwise indicated). 
*f ■ User supplied. Mot verified as to 

accuracy. 
< > ■ Hue of patch to apply before 

copying. Patches are for version 

4.8 only. 
(V4.ll = PARfls for version 4.1 only. 




NOTE: Khen following instructions 
below, do each step in the order listed. 
Change paras before copying tracks 
indicated to the left of the periods. 
Previously entered PARMs retain as 
changed unless changes are indicated in 
subsequent lines. 

If a particular proorai is not listed, 
try tracks 0-22 noreal. Prograis that 
only require 70-T22 norsal are not 
listed due to space constraints. 

A2-FS1 (New as of 11-1-811 


1.5-21 BY 1,5 44-DB 45=AB 4i=BF 

40=20 4E=08 54= J 2 
7-fl 
9.5 

AIRSIM - 1 (NOTE 2) 

S 0-2 ,...A8=B5 78=00 79=12 47=FF 

3 9-22 

S 3-8 79=8E (ERR ON TRK 8 OKI 

AKALABETK 

S 0-18 44=DD 

ALIEN TYPHOON ** 
S 0-E 

ALIEN TYPHOON » 
0-0 

1-5 46=AD 

6-E..... 44«DE 

APPLE-OIDS ** 
0-Z2 
3.5-3.5 
21.5-21.5 

APPLE PANIC 

m 

APPLE PANIC m ■" 
0-0 
1-C 44=DD 

APPLE PRINT USIN6 »* 
S 0-23 

APPLE HQRLD 
0-23 

APPLENRITER (APPLE ///} 
S 0-22 

AUTOBAHN ' 
0-0 

4-6 74»80 

9.5-C.5 

BAG OF TRICKS »* V 

1-14 48=10 44=Do 53-00 

BATTLE OF SHILOH ** 

Sase as TORPEDO FIRE 
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BEER RUN « v 

HI 18=28 19*80 46*94 40=00 

4E«00 52*00 53=08 54=12 
57*00 40*20 
S 1.5-5.5 

BEER RUN *♦ J 
0-0 

S 1.5-D.5 72-00 73*00 77*00 78=00 

79-12 7O00 40-20 19*00 
44-DD 45=AD 46=DA 

BPI BUSINESS ACC0UNTIN6 SYSTEH 

(All 4 distcs -Revised 11/26/91) 

0-22 19*00 21*02 59=19 59=06 

5A-1A 5B=FF BD-44 BE=£6 
BF=45 C0*FF Cl=40 C2=01 
C4*44 C5-D5 C6*45 C7«AA 
C8=40 C9=04 CA-00 

CARTELS AND CUTTHROATS ** 
Sate is TORPEDO FIRE 

CASTLE OF DARKNESS ** 

S ff~5i i a * •46 s t6 

S J-23,........44-ABy45=AB 79=12 

CASTLE NOLFENSTEIK t 
S 0-22 

COMPUTER AIR COHBAT 

0-22 25*19 45*00 48*00 

CONTEXT CONNECTION 

Sate as DESK TOP PLAN II 

COPTS I ROBBERS J 

0-0 (PARNS sate as GORGON) 

S 1.5-F.5 (PARKS sate as GORGON) 

CRANSTON MANOR «*/ 
0-22 

IB 53*00 44=D5 45=FE 4C=1B 

57-00 

CROSSFIRE ** */ (NOTE 3) 

0-22 

1 4C*1B <NC38> 

4C*tB 57=00 E9=02 (V4.ll 

CROSSWORD MAGIC t* J 

S 0-22 44*94 75=00 76*00 77*00 

79=00 79=12 48=AA 

CRUNCH. CRUMBLE fc CHOHP " ■J 
3 0-22 

CYBERSTRIKE ^ 


S 4-B 46=F5 79*12 

11-1C 46=B5 

DARK FOREST " *? 
S 0-22 

DARK FOREST M * 

18=20 19=00 46=96 4D=00 

4E=00 52*00 53*00 54=12 

57=00 40=20 

S 2-22 72=00 73=00 77*00 78=00 

79*12 7C=00 40=20 19=00 

44=05 45*AA 46=AF 



BATADEX 

S 0-2 79=12 46=96 

S 3.5 
5 5-22 

DATA FACTORY 5.0 (NOTE 2,4) 

S 0-2! 46=96 79=12 71=19 75=00 

76=00 77=00 78*00 
DATA PLAN ** 
S 0-22 

DATA REPORTER 

0-22 40=08 46=96 54=12 

DB MASTER AND UTILITIES DISK (NOTE 2) 
S 0-5 
6. 5-22. S 

DESK TOP PLAN II 

0-22 19-00 21=02 59*19 59*06 

5A*1A 5B=FF BD=44 BE=EB 
BF-45 C0=FD Cl=40 C2=01 
C4=44 C5=D5 C6=45 C7=AA 
CB=40 C9=06 CA-00 

DISK ORGANIZER II ** ^ (NOTE 3) 


3 2-4 
S A-B 

1 4C=1B <NC30> 

4C*1B 57=00 E9=04 (V4.il 

DISK RECOVERY » ^ 


3 2-4 
S A-B 

EPOCH (REVISED AS OF 10-26) V" 

18=20 19=00 44=96 4D=00 

4E*00 52*00 53=00 54*12 

57=00 40=20 
S 1.5-F.5 72=00 73=00 77=00 78-00 

79=12 7C=00 40*28 19=00 

44«D5 45-AA 46«DA 

ESCAPE FROM ARCTURUS J 
8-22 40=00 

EXECUTIVE SECRETARY 

0-22 46=96 54=12 

EXPEDITER EMOTE 3) 

0-22 

3 !c IF 4E=1B <NC30> 

4C=1B 57=00 E9*82 (V4.ll 

FALCONS ** (New as of 12/21/81) ^ 



1.5-4.5 BY 1.5. ..18-20 34-AA 44*DF 
45=AD 46=FE 
(IF THE ABOVE FARMS DON'T HORK TRY: 
19=40 19=00 34=AA 40=40 44-DF 45=AD 
46=00 4E=00 4D=00 52=00 53=80) 

5.5 

7-A BY 1 

B.5-E.5 BY 1.5 

10-12 BY 1 

13.5-14.5 BY 1 

16-19 BY 1,5 

1A-1B.5 BY 1.5 

FALCONS ** V 

S 

S 1.5-19.5 



FINANCIAL CONTROLLER (ALL 5 DISKS) »* 
S 0-22 

FIREBIRD \J 

19*20 19=00 44*96 40=00 

4E=00 52=00 53=00 54*12 

57=00 40*20 
S 1.5-B.5 BY 1 72=00 73=00 77-00 

78-00 79-12 7C-00 48-20 

19=00 44=DD 45* AD 46=DA 

SAMMA GOBLINS »* 
Sate as SNEAKERS 

6ENETIC DRIFT *# 

....18*50 19*00 40*20 46*96 

40-00 4E-00 52-00 53*00 

54*12 57=00 

1-3 44=38 45-D5 44-BB 

4,5-6 BY 1.5 
7.5-B.3 BY 1 

D 44*04 45*05 44=BB 

E. 5-12. 5 44-AD 45-B5 44-DE 

60BLER / (NOTE 5) 

0-22 4E-00 v/ 

3..., 4C-1B 02*00 45-BD 4E-01 

34=FF 54*12 52*00 

SOS60N (NEW AS OF 11-1-81) * 

18-20 19-00 44-96 4D-00 

4£=00 52=80 53=00 54-12 

57*00 40*20 
S 1.5-E.5.... ..72*00 73*00 77*00 7B-00 

79*12 7C*00 40*20 19-00 

44*00 45=ftD 44-DA 

HAYDEN APPLESOFT COMPILER 

S 0-22 44*994 71*19 79*12 

(Errors on 18-1E OK) 

HAYDRON h 

Sate as 60R80N 

HIRES CRIBBA8E AND HIRES FOOTBALL §« \r 
S 0-5 
6-22 

HIRES GOLF ft 

0-22 4E=00 46*B5 54-12 

INVOICE FACTORY (2 DISKS) . 
0-22 46-96 54-12 

JAWBREAKER »* V 
0-22 
3 34-FF 44-DF 45*EF 46-F7 

50*00 51*00 52=00 53*00 

54-12 

LETTER PERFECT 

0-22 44-00 45=05 46-AA 

MAGIC WINDOW 

0-22 4F-0B 

MASTER TYPE \/ 
8-2 

3-1A 44-D4 

1C-22 

MICRO BASEBALL « 
0-4 

S 5-22 
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MICRO COURIER 
B-22 

IF 81=97 82=EB 4f-fB 16=08 

41-FF 19=00 5S-8B 59=FF 

MICRO TELESRAH 

Sa»e as MICRO COURIER 

MICROWAVE v 
8-22 
11 4C=1B 57=08 E9=02 

MISSLE DEFENSE V 
S 0-22 

HULTI DISK CATALOG III h " 
S 0-22 

NIGHT MISSION *♦ (NOTE 2) 



1-15... 4MB 45=AB 46=DF 40=20 

4E=88 54-12 

OLYMPIC OECATHALON V^ 

S 0-22 46*65 A8=80 71=10 79=12 

OD-TOPOS V 

0-22 21-02 

ORBITROK (5t» i\ SOR&ON) <S 

OPERATION APOCALYPSE 

0-22 25-19 65=00 6B=00 

OUTPOST (Saae as SNEAKERS) \/ 

PALACE IN THUNDERLAND 
8-22 25=19 

PEGASUS II y" (NOTE 31 

0-22 

3...... 4C-1B <NC38> 

4C=1B 57=08 E9=02 (V4.1) 

PFS ** (NOTE 2) 

Saw if PFS REPORTS (Track error 
■ay occur) 

PFS REPORTS 

1-13 

40=08 41-FF 16=08 19=80 

58-08 59-FF 54-12 12*02 
44*93 45-F3 46=FC 47=FF 
81=93 B2-F3 S3-FC 34-FF 

PHANTOMS FIVE ^ 

2-IC 44-DD 

POOL 1.5 ^ 

S 0-15 46=95 79=12 

S 1E-21 

PRESIDENT ELECT (Revised as of 18/23/811 
0-22 25=19 6B=80 

PUCKMAN \J 

i, 54-12 

1-0 54=09 

PULSAR II %/ 

S 

S 1C.5-1D.5 

S 2-C 44-DD 

S 13-19 
S 1A.5-1B.5 
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OUICK LOADER ** 


s 2-n 

RASTER BLASTER (Old version} \# 


S 5-11 BY 4....44-AD 45-DE 53=00 
S 6-12 BY 4 
S 7.5-F.5 BY 4 
S 1.5-3.5 BY 2 

RASTER BLASTER (New version) M/ 

•<46=96 54-12 

S S-ii'BM.'.'.'.^-AD 45=DE 46=00 72=80 
73=00 75=80 78=08 79=12 
S 6-12 BY 4 
S 7.5-F.5 BY 4 
S 1.5-3.5 BY 2 

R1N6S OF SATURN I* 
S 0-2 SYNC 

3-22 
S 5 SYNC 
S 9 SYNC 

SABATD6E h/ (NOTE 3) 
8-22 

3 4C=1B <NC30> 

4C=iB 57=00 E9=02 (V4.ll 

SARGON II *t */ 

0-1A 19*00 54-12 

SHATTERED ALLIANCE 
0-22 25=19 

SHATTERED ALLIANCE (Men) 

4C-1S 47-FF 53-0B 54=12 

1-22 . +4=D4 46=B7 

SIN8A SHAPE MANAGER »* 
S 0-22 

SNAKEBITE «* Sane as EOR60N 

SNEAKERS v 

18=20 19=00 46»96 4D=80 

4E-88 52*00 53=88 54=12 

57*08 48=20 
S 1.5-D.5 BY 1.5 72=80 73*08 77=80 

7B=08 79=12 7C=88 40=20 

19=00 44-DD 45*AD 46=DA 

SNOGGLE *t \J 

0-9 
OR 

0-F 
S 10.5-11.5 

SOFTPORN. ADVENTURE V (NOTE 3) 
0-22 

3 4C-1B <NC30> 

4C-1B 57=08 E9=02 1V4.11 

SOUTHERN COMMAND ** 

0-22 25=19 6B=88 34*05 35=AB 

SPACE EGOS V 


2-6 
11-13 
14-1A 44-DD 
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SPACE BUARKS V^ 

18=50 19=80 40*20 46=96 

4D=08 4E=80 52=00 53=00 
54=12 57=00 

1-2 ,44=AB 45=04 46=AB 

3.5-5.5 
7 

9 44=FE 45=DD 4fc=AF 

A.5-B.5 44=AA 45=DE 46=BB 

0-15 J 

SPACE WARRIOR V 

18=50 19=08 40=20 46=96 

4E=88 52=80 53=80 54=! 2 

57=80 

2.5-3.5 44=DF 45=AD 46=DE 

5-8 BY 3 
6.5 
A-10 BY 3 

STAR CRUISER If-V 

S 8-3 BY 3 

S 5-B BY 1 

S 11-12 

S 4 44=AA 45-DD 44=BB 

STAK NINES #* 


1-2 46-AD 

4-A 

STAR RAIDERS h 

0-5 (Track 5 error lay occur! 

STAR THIEFV' (NOTE 31 

0-13 (Track E-13 errors »ay occur) 

22 4C-1B <NC30> 

4C=!B 57*00 £9-02 (V4.1) 

SUPER APPLE BASIC ** 
0-22 
3 .(Use EXTENDED RETRY! 

SUPERSCRIBE II 
0-22 
3 45=88 58=80 

SUPERSCRIBE II *t 
Sate as PEGASUS II 

TAX PREPARER 

8-22.. ....... 46=96 54=12 4C=19 

THEIF \S 

8-22.. B3=FF 4F=0B 53=08 

S 4-5 38-02 1£*02 19-00 12-81 

7C=80 

THRESHOLD (NOTE 3) 

0-22 

1-23 BY 22...4C-1B <NC30> 
4C*1B 57-88 E9-02 (V4.ll 

TIGERS IN THE SNOW t* 

Sane as PRESIDENT ELECT 

TIME ZONE (Disk ill 
S 8-4 
5-22 

TIME ZONE (All other disks) 
0-22 

TINY TROL 
0-22 
3.5-5 BY 1.5 
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TORPEDO FIRE 

1-22 4F<« 

TWERPS h 

Saae as S0R60N 

S 1.5-E.3 Saae as 60RSGN 

1A 4C=iB 57=08 £9=82 

ULTIMA 

8-22., 1E=0B 

ULYSIS ** (NOTE 3) 

8-22 

3 4C=1B <NC30> 

4C=I8 57=88 E9=02 (V4.1) 

VISICALC (COS 3.3 Version) 

0-22 (Error on tract; 1 is §K) 

VISICALC (APPLE ///) 
S 8-22 

VISIDEX (Change as of 11/18/81) 

8-22 48=84 16=88 41*FF 19=88 

5B=0B 59=FF 81=AA B2=EB 

83=FD 21=82 46=94 54=12 

VISIFILE 

Sate as DESK TOP PLAN II except use 
PflRfl C8=EC 

VIS I SCHEDULE ** 

8-22 48=84 16=88 41=FF 19=08 

58=8B 59=FF 81=flft 82=EB 
83=EC 

VISITERS 

0-22 

6 40=0B 16=08 41=FF 19=08 

5B=0B 59=FF Bl-AA 82=EB 

83-FC 

VISITREND/VISIPLOT 
0-22 

7 40=88 16-08 41=FF 19=80 

81=DE B2=AA 58=8B 59=FF 

HARP FACTOR » 

Sate as TORPEDO FIRE 

WIZARDRY (<^T£jO^P (NDTE 1,2) 
8-9 t*r$rf TAIL $ *— i?'i 

f-22 #vy I' V 

S A-E 34* J 

WIZARDRY h $&&&**} (NOTE 1,2) 

36=81 21=82 46=96 

S 1-22 34=00 

ZORK (Old versions) V (NOTE 3) 

0-22 1E=0B 

3 4C=1B <NC30> 

4C=1B 57*08 E9=02 (V4.1) 

I0RK I and ZORK II (New versions) J 
8-22 46*96 48=!4 



NOTE 1 Uses nibble count which 
requires drive speed adjtistaent with 
either the < > signs or by reaoving. the 
drive cover and adjusting actual speed. 



NOTE 2 Put a write-protect tab on the 
copy disk before using it. 

NOTE 3 Patches listed below should be 
entered before starting copy routines 
unless otherwise indicated. These 
patches work only for version 4.8. They 
are built into version 4.1. Entering 
then into 4.1 will result in an 
'INCORRECT PATCH' error. Nhen using 
patches, enter then as shown with no 
spaces. 

NAME ENTER AS LISTED BELOW 

NUT - NULTN8N6S/RP 

This patch, when applied first, 
allows aultiple patches to be 

LS6P - LSSPNJNFH/G//LA/L8/H/ZN6EKCPSWQ 

Use as directed 
NC38 - NC38WKDJQ8SJ/EBQSJ/EY/ 

Use as directed (When PARK 4C is 

changed to IB) 
SI9K - SI9KWRTY//AWRTU7NAWRTG7/ 

Allows using SUentype or 

Trendcoa printers 

NOTE 4 To Boot disk follow these 
steps: 
lJ Boot disk. 

2) When coiputer starts to beep open 
drive door and press reset. 

3) Xhen cotputer prints "BREAK IN 5", 
close drive door and press reset. 

4) use prograi. 

NOTE 5 In this set of PARMs changing 
4C to IB will not invoke nibble count' 
preservation since PARK D2 is set to 08, 



SPECIAL NOTE: (VERSION 4,0 ONLY) Soae 
Apple disk drives have exhibited 
probleas with the head seek algoritha. 
To determine if your Apple is affected 
by this problsi, perfora the following 
test: 

1) Atteapt *o copy your Lockstith 
disk, track 9 only (no SYNC). 

2) The copy aay fail, but should 
indicate a track start (in the second 
line of the 3 line inverse block) of - 
D5 AD FF. 

3) If this is not the case, your 
drives exhibit the problei, and you 
should apply patch LSSP after booting 
Lockstith. 

If your drives exhibit this problet, 
send your 4.0 version in for a revision 
to version 4.i that solves this problet. 

This parameter information is a re- 
print of several files maintained on the 
Source". If you have any additional 
information, send it to: 

Hardcore Ceniputing 

Copy Notes 

P.O. Box 41549 

Facoaa, HA 9B444 




continued from page 44 

software. He is entitled to a fair return (in cash) 
for his investment (in hours). I also believe that 
he is entitled to all the traffic will bear. The 
Yankee peddler is (thank GOD) still alive and 
well. Competition will manage the cost of 
software without any more help from you or 
me [or any government agency), A good 
many people have become guite wealthy 
because of the personal computer, but some 
can never be satisfied. The law of diminishing 
returns never applied [they think) to them. The 
marketplace will control (eventually) the 
price of software. The copying of overly 
expensive software may become a factor in 
that control. I am not encouraging such 
actions, I only note the probaPlllty The price 
of software needs to be balanced against 
the cost. Reasonably priced software, lightly 
protected, seldom will be copied. If it costs 
you as much or more to copy it (and repro the 
manual) than it costs to buy it, few will copy If. 
There is yet another reason why original soft- 
ware will sell. 

We are a nation of collectors. We collect 
everything from rocks to diamonds and all in 
between. Every collector wants an original, 
not a- copy Eventually it will be a status item 
among collectors to have a particular pro- 
gram on the original disk. Many of us realize 
that and often purchase software (that we 
already have copies of) for that reason 
alone. Who can find an original copy of Dr. 
Memory or Apple DOS 3.0? Remember, 
nobody wanted an Edsel when they were 
new, but now they bring a handsome price 
from collectors. 

So please excuse a writer's runoff at the 
pen, keep up the good work, and if you find 
time to do it some day, how about an In- 
depth explanation of the various protection 
schemes, as they look when you do a sector 
inspection such as with Nibbles Away The 
explanation that accompanies Nibbles is 
utterly lacking in depth. 

Yours, 

Russ McCaffrey Jr. 

N.torrance, CA 



ALL LETTERS SENT TO HARDCORE WILL 
BE TREATED AS UNCONDITIONALLY 
ASSIGNED FOR PUBLICATION AND COPY- 
RIGHT PURPOSES AND THEREFORE MAY BE 
EDITED, PUBLISHED AND COMMENTED 
ON. Publisher disclaims all responsibility 
to return unsolicited editorial material. 
Al! rights in published portions remain 
the sole property of SOFTKEY Publishing. 
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How To MAKE PARAMETER CHANGES 



This file was lasted updated- < May 
21, 1982 

The parameters below can be 
accessed from "The Source" by typing: 
TY (1 2JTCD328 < NIBBLESAWAY 

from the command mode. 

Listed below are the parameters to 
change in order to back-up certain 
pieces of software which require more 
than the default values given with Nib- 
bles Away ][. If a number Is listed within 
the "less than" (>) and "greater than" 
[ < ) signs, it corresponds to the number 
of the Auto-Load file which will perform 
the listed function. To use the Auto-Load 
files, see Chapter 6 in the Nibbles Away 
][ manual. 

To back-up a program, first find its 
name in the list of parameters. Directly 
across from the file name is the Auto- 
Load file to use, if one exists. Remember 
that Auto-Load files are within the "less 
than" and "greater than" signs, 

Directly below the name is a list of the 
tracks to copy and what parameter 
changes to make. If the letter "S" 
appears to the far left of the track num- 
ber, set the "SYNC" mode before copy- 
ing these tracks, If the word "BY" is used, 
set the increment to this value, other- 
wise use the default increment of 1, 
Parameters which are assigned values 
can be accessed under the Control 
Parameter Modifier. The parameters 
"ADDR" and "INS" should be entered 
under "ADDRESS MARK" and "INSERT 
MARK', respectively, in the Backup Mod- 
ifier. 

When the word SECTMOD appears 
below, it means that a sector should be 
changed using the Track/Sector Editor 
(JSE). Place the destination disk into 
drive 1, then perform the changes 
listed. The command format is: 
SECTMOD [.F=NN,C = XX,S=YY.T=ZZ1 
CHANGE ADDRESS M FROM A2 TO A3 
The meaning of NN,XX,YY,ZZ and 
A1 ,A2,A3 are explained below: 

NN-Thls will be either 13 or 16, and 
represents the disk format to be used. 
This should be set by selecting the "O" 
option in the TSE, then pressing V until 
the proper format is shown in Inverse. 

XX— This wilt be either on or off, and 
should be set using the Checksum 
option on the Options page, as above 
('C to toggle). 
YY— This is the sector to be read. 
ZZ-This is the track to be read. (See 
Nibbles Away ][ manual for detaiis on 
how to set these) 

After setting these options, use the "R" 
option to read the given sector into the 




buffer. Then change the information in 
the sector, following the convention 
listed below: 

A1— This is the location to be 
changed in the buffer. 

A2— This is the old value. 

A3— This is the new value, 

If multiple changes are listed, they 
should be performed in sequence. 
After making changes to a sector, it 
should be written back to the disk with 
the "W" option. 

Note: Parameters from Nibbles Away 
I may be used in Nibbles Away ][. They 
must be entered using the name of the 
desired parameter listed in the Nibbles 
Away I manual. Nibbles Away I param- 
eters may not be entered under the 
global modifier in Nibbles Away ][. 

The following example shows a file 
that incorporates many changes. Step- 
by-step directions will be given on how 
to copy this program. Line numbers 
have been added to each line for refer- 
ence. These numbers do not appear in 
the parameter list. 

1) EXAMPLE FILE <XXX> 

2) 0-5 ADDR=D5 AA % 

3) SECTHQD tF«16,C»0FF t T«M,S-l33 

4) CHANGE ADDRESS +2 FROM 38 TO ifi 



5> OVERIDE STANDARDIZE* 

6) S A-9 BY 1,5,....ADDR«DD AD DA 
8) 11-22 BV 2.... INS=ADFB E6 FF E6 
1) SYNC SIZ**A 

It) DATA HAX=25 

Line 1 contains the name of the pro- 
gram ('EXAMPLE FILE 1 ), and the abbre- 
viation of the company that markets the 
program ['XXX') in parentheses. The 
name of the company can be found In 
the table of abbreviations. 

Line 2 gives the tracks to copy and 
what parameter changes to make 
before copying the tracks. First set the 
ADDR parameter to D5 AA 96. These 
changes are made from the Backup 
menu. To get to the Backup menu first 
enter the Modify Parameter menu CM" 
from the main menu), then press "B." 

Line 3 shows that some special 
changes must be made to a certain 
sector (track 00, sector 3). Enter the TSE 
and use the "O" command to select the 
following options; 
F. . .Setup for 16 sector, 
C. , .Turn the CHECKSUM FLAG off. 
Track 00, sector 3, needs to be read. 
Type "T" then 00, and "S" then 3. Use the 
"R" command to read the proper track/ 
sector. 

Line 4) After the sector is in memory, 
change address 42 from 38 (what It 
originally was) to 18. Write the track 
back to the disk using the "W" com- 
mand. 

Line 5) Enter the Backup menu. From 
this menu answer yes (T) to the ques- 
tion "OVERIDE STANDARD1ZER," 

Line 6) Set the synchronized copy 
mode when copying tracks 6-9. The "S" 
means make a synchronized copy. Also 
set the increment to 1 .5. 

Before copying tracks 6-9, set 
the ADDR to DD AD DA. 

Line 8) Copy tracks 11-22 with an 
increment of 2. Set INS to AD FB E6 FF E6. 
The changes to INS are made from the 
Backup menu. 

Line 9) Set the SYNC SIZe to 0A. To 
change SYNC SIZes enter the Modify 
Parameter menu, and from this menu 
enter the Control menu ('C). Use the 
arrow keys to move the cursor to the 
SYNC SIZe (2nd column, third one down) 
and press the space bar to change this 
value, in our case to 0A. 

Line 10) The DATA MAX value Is 
changed in the same manner as the 
SYNC SIZe. 
The file is now copied (yea!), 

NOTE: The following company names 
and software titles are copyrighted 
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and/or trodemarked. An abbreviation 
of the company which reserves these 
rights follows each software title. A list of 
the abbreviations and the name of the 
company each represents may be 
found at the end of the parameter lists. 

Prograt Nate (Coapany) (Auto-load frit) 
Tracks to Copy Paraaeters to change 

ACCOUNTING SYSTEM (BR!) <15> 

8-22.... AI)DR=D5 AA 96 

M-U INS=AD FB £6 FF £6 

SYNC SIZ-M 

APPLE PANIC IBS) / 

H 

APPLE WORLD (USA) 
0- 23 

APPLE WRITER /// (APC) 
S 8-22 

AUTOBAHN (SRS) <6> 

S H 
3 4-6 
S 9.5-C.5 

A2-FS-1 (SBL) */ <13> 

8-a 
1.5-2! BY 1.5..ABDR*DB AS BF 

REDUCED ERROR CHECK 

7-3 REDUCED ERROR CHECK 

9.5-9.5 REDUCED ERROR CHECK 

A2-PB1 FINBALL (SBL) 

0-0... ADDR»D5 AA 96 

DATA HAX-25 
1-15 ADDR«DB AB SF 

BEER RON (SRS) 

5 0-0 ADDR-OD AD DA 

DATA HAWS 
S 1.5-13.5 

NOTE; Errors mil begin to occur soie- 
where bettteen track C.S and track 13.5, 
depending on the particular disk. This 
is aortal. 

BOSS (SRS)^ 

S 0-0 ADDR=DD AD DA 

S 1.5-B.5 
S D-20 

CANN0N8ALL BLITZ (0LS) ¥ 

S-22 ADDR=D5 AA «i 

SECTKOD £F»16,C=ON L T=i7,S=0E] 
CHANGE ADDRESS CD FROM 4? TO 60 

CASINO 21 (DM 

0-22 ...ADDR*D5 AA 96 

SECTHOD £ F» 1 6 , C*0FF , S-03 , T=SS 3 

CHAN6E ADDRESS 63 FftOH 38 TO IB 

CEILINB ZERO (TKS) 

0-2 ADDR»D5 AA B5 

3-11 ADDR=D6 AA B5 

1NS-DE AA EB F9, SYNC SIZ»0A 

COPTS St ROBBERS (SRS) Sate as Beer Run 

COUNTY FAIR (DH> V 

0-22 A0DR=O5 AA B5 



CRANSTON MANOR (OLS) ¥ 
0-22 ERASE BEST TRACKS 

DARK FOREST (SRS)V 

S 0-0 ADDR-OD AD DA 

S 1-22 ADDR<=D5 AA A5 

(Errors on i-8 and last few tracks OKI 

DB MASTER (OLD) (STH) <9> 

0-5 ADDR=D5 AA 96 

6.5-22.5 

DB flASTER (NEW) (STB) 09) 

S 0-5 ADDR"D5 AA 96 

6.5-22,5 

DEADLINE (10 (DOS 3.3) 

1-22 ADDR-D5 AA 96 

DESKTOP PLAN II fVCP) <16> 

0-22 ADDR=D5 AA 96 

INS-AA EB FD 

SYNC SIZ=0A, FIX AHNT»04 

DUNS BEETLES (OS) \J 

0-0 ADDR-D5 AA B5 

H ADDR=F5 F6 F7 

4-22 

SECTHOD [F=13,C»0H,T-«,S-«) 
CHANGE ADDRESS 60 FROH 01 TO 7B 
CHANGE ADDRESS 6E FROH 61 TO 69 

ELIHINATOR (AH \J 

0-21 ADDR-D5 AA 96 

SECTHOD [F*i6.C-QFF,T=03,S=0BJ 
CHANGE ADDRESS 2E FROH 20 TO EA 
CHANGE ADDRESS 2F FROH 30 TO EA 
CHANGE ADDRESS 30 FROH 72 TO EA 

EPOCH (SRS) -Sate as Beer Run J 

ESCAPE (SBL) <DOS 3.3> 

0-22 ADDR=D5 AA 96 

ESCAPE FROH ARCTORUS (SNS) V 

0-22 ..ADDR*D5 AA 96 

OVERIDE STANDARDIZER 
OVERIDE NIBBLE FILTER 

EXECUTIVE SECRETARY (PBS) 

0-22 ADDR=D5 AA 96 

DOS 3.3 

EXPEDITER II (OLS) <2> 

0-22 ADDR=D5 AA 96 

ERASE BEST TRACKS 

FIREBIRD IBS) V <7> 

S 0-0 ADDR=DD AD DA 

S 1.5-B.5 

GANHA GOBLINS (SRS) 

S 0-0 ADDR=OD AD DA 

S 1.5-B.5 

S D-D MDR-FF FF FF D5 AA EE 

DATA HAX=30 

GENETIC DRIFT (BS)^/ 

0-0 ADDR=D5 AA B5 

1-3 ADDR=BB D5 BB 

4.5-6 BY 1.5 
7.5-B.5 

D-D ADDR=D4 D5 BB 

E. 5-12. 5 ADDR-AD B5 DE 



GOBBLER (OLS) J (1> 

0-22 ADDR=D5 AA B5 

ERASE DEST TRACKS 

SOLD RUSH (SS) <DOS 3.3> 

0-22 ADDR*D5 AA 96 

GORGON (SRG) V 

S 0-0 ADDR-DD AD DA 

DATA NAX=25 
S 1.5-C.5 
S E.5-E.5 
S D.5-D.5 ADDR-D5 AA 65 

GUARDIAN (CTS) 

0-1 ADDR=D5 AA B5 

2-11 ADDR«D6 AA B5 

INS'DF AA EB F7, SYNC SIZ=0A 

HAORON (SRS) Sate as Beer Run 

HIRES ADV fl (OLS) J <DOS 3.2) 

0-22 ADDR-D5 AA B5 

HIRES ADV 12 (OLS) i/ <DOS 3.2> 
0-22 ADDfi'DS AA B5 

HIRES CRIBBA6E (OLS) W <20> 

S 0-22 ADDR=D5 AA B5 

INTERNATIONAL GRAND Mill (RBS) s/ 
0-C ADDR-FF FF FF AA 

INVOICE FACTORY (HI) <DOS 3.3> 
0-22 ADDR'05 AA 96 

JABBERTALKY (HT) (DOS 3.3> 

0-22 ADDR'DS AA ?6 

JAN BREAKER (OLS) V m 

0-22 ADDR*D3 AA B5 

ERASE DEST TRACKS 

LETTER PERFECT (LJK) (DOS 3.2> 
0-22 ADDR-D5 AA B5 

HASTER TYPE (LNS) \S 

0-2 ADDR*D5 AA B5 

3-22.... ADDR=04 AA 65 

(ERROR ON *1B OK) 
SECTHOD IF«i3 1 C«0FF,W3,T-H] 
CHANGE ADDRESS 63 FROH 38 TO 18 
SECTHOD £F=13,C=OFF,S-0A,T=«2J 
CHANGE ADDRESS 2E FROH 23 TO 2E 

HICROWAVE (EC»>/ 

0-22..,.. A0BR=D5 AA 96 

SECTHOD CF=16 1 C«ON,T=02,S=01] 
CHANGE ADDRESS DA FROH fa TO AD 
CHANGE ADDRESS DB FROH 60 TO 03 
CHANGE ADDRESS DC FROH 8D TO 81 
CHANGE ADDRESS DD FROH 7E TO 61 

HISSILE DEFENSE (OLS) ^" <20> 

S 0-22 ADDR»D5 AA B5 

NOUSKATTAEK (OLS) \ ! 

0-22 ADDR»D5 AA 96 

SECTHOD £F*16.C=ON.T=18,S=03J 
CHANGE ADDRESS Bl FROH 49 TO 60 

NEUTRONS (LID <1> 

0-22 ADDR=05 AA 96 
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ORBITRQN ISfiS) 

5 0-0 ADDR=DD AB DA 

DATA «AX=25 
S 1.5-E.5 
F.5-F.5 ADBR=FF 85 D5 AA 

OUTPOST (SRS) W 

S %-% ADDR=DD AD DA 

S i. 5-9.5 

B.5-B.5. ADDR=B5 AA AD 

DATA HAX=25 

PADDLE GRAPHICS fOLS> <20> 

3-23 ADDR=05 AA B5 

S 2 ADDR=D5 AA 85 

PEEPING TON (HL> 

m. ADDR=D5 AA B5 

1-1 ADDR=F5 AB BE 

4-22 

SECTHOD [F=15,C=ON L T=80,S=0n 
CHANGE ADDRESS iO FROM 01 TO 7B 
CHANGE ADDRESS 6E FRO* 60 TO 66 

PEGASUS II (DLS) '*f. <1> 

3-22 ADDR»D5 AA B5 

ERASE DEST TRACKS 

PERSONAL FINANCE NANAEER (SDS) (DOS 3.3> 
0-22 ADDR-D5 AA 96 

PHOTAR (STP) <DOS 3,3> 

0-22 ADDR=05 AA 96 

POOL 1.5 (IDS) ¥ 

0-15 ADDR=D5 AA B5 

1E-21 

SECTMOOC F- 1 3 , C'QFF .T-#B ,3=87 ] 
CHANGE ADDRESS 6A FROM 3D TO 60 
SECTHODIF=13.C=OFF L T=00,S=031 
CHANSE ADDRESS 63 FROM 39 TO IS 

PULSAR H (SRS) * <18> 

0-C 
13-19 
1A.5-1D.5 

RASTER BLASTER (BO W 

S 0-0 ADDft=D5 AA 96 

DATA HIN'IS, DATA HM-41 

S 5-11 BY 4 ADDR=AD DE, DATA KIH-13 

S 6-12 BY 4 
S 7.5-F.5 BY 4 
S 1.5-3.5 BY 2 
/ 
RICOCHET (MT) V <DOS 3.3> 

0-22 ADDR*D5 AA 96 

ROACH HOTEL <HL) 

0-0 ADDR-D5 AA B5 

1-1 ADDR=EE EA FE 

4-22 

SECTHOD [F=13,C=OFF L T=00,S s 0i] 
CHANSE ADDRESS 75 FROM R TO 7B 
CHANGE ADDRESS 76 FROM 61 TO 69 

SNACK ATTACK (DM) J 

i-22 ,,ADDR=D5 AA B5 

SECTHOD IF*13,C=QFF,S=03,T*00] 
CHANGE ADDRESS 63 FROM 38 TO IS 

SNAKE BYTE (SRS) Sane as Beer Run 
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SNEAKERS (SRS) & 

S 0-0 ADDR'DD AD DA 

S 1.5-C.5 

S 0.5-0.5 ADDR=B5 AA B5 / 

SOFTPORN ADVENTURE 3.2 (OLS) * <1> 

0-22 ADDfi"05 AA B5 , 

ERASE DEST TRACKS 
SOFTPORN ADVENTURE 3,3 (OLS) ^ <2> 

0-22 ADDR=D5 AA 96 

ERASE DEST TRACKS 

SPACE QUARKS (BS) V 

0-0 ADDR=D5 AA B5 

1-2 ADDR=FF DP DE 

DATA MAX =25 
3.5-5.5 
7-9 BY 2 
A.5-B.5 
D-15 

SPACE WARRIOR (BS) \/ 

0-0 ADDR=D5 AA B5 

DATA MAX-30 

2.5-3.5 ADDR=DF AD DE 

5-0 BY 3 
6.5-6.5 
A-10 BY 3 

STAR BLASTER (PDS) 

0-0 ADDR«D5 AA 96 

7-21 BY 1.5....ADDR-DF A0 DE 

STAR DANCE (USA) t <DOS 3.2> 

0-22 ADDR'DS AA B5 

SUICIDE (PDS) / 

0-0 ADDR=D5 AA B5 

11.5-22 BY 1.5.ADDR=DF AD DE 

SWASHBUCKLER SDH) V 

0-22 ADDR=D5 AA 96 

TAX PREPARER (HS) <DOS 3.3> 

0-22 ADDR»D5 AA 96 

THRESHOLD (OLS) <1> 

0-22 ADDR-D5 AA B5 

ERASE DEST TRACKS 

TIKE ZONE VI. (OLS) 
DISKS A-L 

0-22 ADDR»D5 AA 96 

QVERIDE STANDARDIZER 
THEN DISK A 

SECTHOD [F-I6 1 C»0N L T«#3,S"I3] 
CHANGE ADDRESS 56 FROM 4C TO 60 
SECTHOD [F=16.C=ON.T=03,S=03] 
CHANSE ADDRESS AB FROM A9 TO 60 

TINE ZONE' VI. 1 (OLS) 
DISKS A-L 

0-22 ADDR'DS AA 96 

OVERIDE STANDARDIZER 
THEN DISK A 

SECTHOD CF=16.C=ON,T=03 L S=001 
CHANSE ADDRESS D9 FROM FC TO 00 
CHANSE ADDRESS mm* 08 TO 13 

TORPEDO FIRE (SS«) 
0-22 ADDR*04 AA B7 

TUNNEL TERROR (HS) 

0-0 ADDR-D5 AA B5 

1-12 ADDR=06 AA B5 

INS=DF AA D7 it, SYNC SIZ=0A 
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TWERPS (SRS) 

S 0-0... ADDR»DD AD DA 

S 1.5-E.5 
IMA 

ULYSSES k GOLDEN FLEECE (OLS) <2> 

0-22... ADDR=D5 AA 96 

ERASE DEST TRACKS 

VISICALC /// (APC) 
S 0-22 

VISICALC 3.3 (VCP) 

0-0 ADDR=D5 AA 96 

2-22 ..ADDR=D5 AA B5 

(ERRORS TOWARD END OK) 

VISIDEX (VCP) 

0-22 ADDR=D5 AA 96 

INS=DE AA EB FD 

SYNC SIZ-fA, FIX ANNT*04 

VISIFACTORY (ML) 

0-22 AD0R=D5 AA 96 

SECTHOD EF=16,C=OFF,T=00,5«031 
CHANGE ADDRESS 42 FROM 38 TO IS 
SECTHOD EF=16.C*OFF,T=0i,S=00J 
CHANGE ADDRESS 84 FROM 4C TO AD 
CHANGE ADDRESS 85 FROM 3E TO E? 
CHANGE ADDRESS 86 FROM AE TO B7 

VI5IFILE (VCP) 

0-22 ADDR»D5- AA 96 

INS=DE AA EB 

SYNC SIZ-0A, FIX AHNW4 

VISISCHEDOLE (VCP) 

0-22 ADDR=D5 AA 96 

INS'DE AA EB 

SYNC SIZ-0A, FIX AHNT*04 

VISITERH (VCP) v 
0-22,.... AD0R"D5 AA 96 

INS=BE AA EB FC 

SYNC SIZ=0A, FIX AMNT=04 

VISITREND/VISIPLOT (VCP) 

0-22 ADDR=D5 AA 96 

INS=DE AA EB 

SYNC SIZ=0A, FIX AHNT=04 

WORD HANDLER II (SVS) 

0-0 ADDR-D5 AA 96 

11-22 

1-C ,...ADDR=FF DF DE 

ZERO GRAVITY PINBALL (AGO <DOS 3.2> 
0-22 ADDR=D5 AA B5 



t#tll##tlM#Hf*tl#f*tHltlt#ttt#tHtlttl 

Table of Abbreviations of Publishers 



AC 


APPLE COMPUTER 


ASC 


AVANTE GARDE CREATIONS 


AI 


ADVENTURE INTERNATIONAL 


BC 


BUDGCO 


BPI 


BPI 


BS 


BRODERBUND SOFTWARE 


cc 


CAVALIER COMPUTER 


CTS 


CONTINENTAL SOFTWARE 


DH 


DATA HOST 


DS 


DATA SOFT 
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6EBELU SOFTWARE 
HDWAflDSOFT 

IHFOCOM 

INNOVATIVE DESISN SOFTWARE 

UK ENTERPRISES 

LEVEL 10 SOFTWARE 

LI6NTNIN6 SOFTWARE 

MASNA SOFT 

MICRO LAB 

HIND TOYS 

ONLINE SVSTEHS 

PERSONAL BUSINESS SYSTEMS 

PICAOILLV SOFTWARE 

PROFESSIONAL SOFTWARE TECHNOLOGY 
RBS RIVERBANK SOFTWARE 
5RS SIRIUS SOFTWARE 
SS SENHENT SOFTWARE 
STP SOFTAPE 

SVS SILICON VALLEY SOFTWARE 
TKS TURNKEY SOFTWARE 
USA USA SOFTWARE 
VCP VISICORP 

This parameter inforiatiofi is a re- 
print of several files maintained on the 
'Source". H you have any additional 
infornatitm, send it to! 

Hardcore Computing 

Copy Notes 

P.O. Box 44549 
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INTERVIEW 



continued from page 1 3 

MARKKULA When you look at it from an 
industry basis, you have to look at volume, 
not just the software pirate industry which is 
very cliquish. And you have to question how 
many copiesare being made, and are legiti- 
mate potential customers turning to the cop- 
iers In preference to buying the program. 
And if they are, what percentage of them are 
, , , and why are they? Do they feel that the 
price is too high for what the manufacturers 
are offering? Do they feel that they are being 
ripped off? Do they prefer working with the 
people who offer the copies? Do they find it 
too difficult to find the original product? Or do 
they learn of the product through the copy- 
ing network and that's why they get it that 
way instead of seeing it at a computer store 
where they can buy it legitimately? There's 
just a million questions that needs to be 
asked. 

What people have to realize is that we 
have to put some work into the solution. It's 
not just going to Pe presented and then eve- 
rything is going to be fine. We're a responsi- 
Ple industy and we have to work at it, 

HARDCORE: And right now you feel that you 



are doing your part in uncovering the solu- 
tions? 

MARKKULA: We're working at it. I hope that 
we'll be successful, that we'll be the guys who 
will present a workable solution or help to 
create a workable solution. I think that it 
would be a feather in our cap and one thing 
that we could then say about Apple is that 
we TRY todo things that are right for the indus- 
try 

HARDCORE: Is there anything that you 
would like to add, especially regarding the 
quotes used by major computer magazines? 

MARKKULA: Only that it was taken out of 
context. It is true. We are against software 
protection. We don't think that in the long 
term it is the Pest thing for the industry or the 
customer. On the other hand, it is not possible 
for us to propose a fully acceptable solution 
at this time So. in light of that, we're going to 
work on it. And we'd like to have anyone else 
who wants to help assist us in trying to put 
together on organization that will come up 
with a solution. 



Why you need The Inspector. 



If you're serious about programming, you need 
to set all your utilities together in one place — 
inside your Apple. The Inspector comes on an 
Eprom that simply plugs into the D8 socket, or on 
a disk ready to merge with Integer Basic for 
automatic loading on boot. Either way, it stays at 
your fingertips, ready to call without disturbing 
your current program. 

The Inspector puts you in total control of both 
memory and disks. You can search forward 
and backwards, edit, read nibbles, 
map disk space, dump the screen 
to a printer, examine every secret 
of your Apple. Use The Inspector 
to repair blown disks, undelete 
files, input "illegal" commands, 




read and alter files, locate strings in memory or on 
disk. The uses are endless. The manual, alone, is an 
education. And it's always there when you need it. 

You need the most powerful disk and memory 
utility available for your Apple. You need the 

Inspector. 

See your local dealer, or order direct for just 
$49.95. Mastercard and Visa holders order 
toll-free, 1-800-83 5-2246. 



<OAAA/° 

OAAEGA MICROWftREJNG 

222 SO. RIVERSIDE PLAZA 

CHICAGO, IL 60606 

312-648-1944 



Apple Is a revered Lrademirii of Apple UrnipuLtr. inc. 
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The following is a reprint of a docu- 
ment describing the procedure for 
backing up disks which cannot be cop- 
ied with the standard Nibbles Away ][ 



parameters. This Information can be 
found on "The Source." (a Modem- 
based data communications network.) 
Access the file from command by enter- 



ing: <TY(12)TCD328<NAI1. 

This information has been edited for 
publication, 



HOW TO MAKE BACKUPS- 
A STEP BY STEP GUIDE 



There are three basic steps to back- 
up a diskette: 

1. Locate the tracks which contain 
data. 

2. Find the address marker for the 
sectors there. 

3. Determine if any additional protec- 
tion is used. (This is the hard onel) 



Track/Bit Editor 

For most of the procedures below, a 
basic working knowledge of the Track/ 
Bit Editor (TBE) is required. For those who 
are not familiar with the TBE, an overall 
'description and some examples are 
given below. 

The examples are easier to under- 
stand if they are performed while read- 
ing the instructions, so boot Nibbles 
Away ][ and try them out to get a better 
understanding of what is going on. 

Enter the TBE by selecting option "T" 
from the main menu. A large section of 
numbers will appear on the screen, with 
two dashed lines at the top. The Infor- 
mation between these lines is the status 
information. It shows such things as cur- 
sor position and track number. It is also 
the location where various prompts 
appear for certain functions. The num- 
bers at the bottom are separated into 
two sections. On the left are the starting 
memory addresses for each line to the 
right, 

Move the cursor around using l,J,K or 
M, and watch the ADDR indicator in the 
status line. It will show exactly what 
memory address the value under the 
cursor represents. 

The arrow keys change the area of 
memory that can be seen. They shift the 
view 256 bytes forward or backward at 
a time. The only really important thing to 
know for this discussion is how to use the 
arrow keys to move the viewing 'win- 
dow' around in memory. 

The l ';" (unshifted " + 1 and the "-" keys 
increment and decrement the track 
number in the status line. 

Pressing "R" will cause drive one to 
read the data from the track indicated 
in the status line into memory. The bytes 
on the screen will change, since differ- 
ent data has been read. Pressing the 



"R" key multiple times will result in differ- 
ent data being displayed. This is 
because Nibbles Away ][ starts reading 
at whatever point happens to be under 
the Read/Write head when the drive is 
turned on, The data is not actually dif- 
ferent, it is just not loaded at the same 
memory location as it was previously. 

Step 1 : Locate the Tracks with Data 

To begin, the track pointer should be 
set to track $00. Pressing "R" will read 
the track and show it on the screen. The 
arrow keys should be used to move the 
viewing 'window' to start at $2000. 

Now move forward and try to deter- 
mine if this track contains valid data. 
Actually, track $00 must contain some 
data in order for the disk to boot, but we 
will be using this procedure on other 
tracks which do not necessarily contain 
data. 



Gaps 



The main thing which will identify a 
track as containing data is the pres- 
ence of gaps, Gaps are sections of the 
same byte repeated several times, Nor- 
mally they are made up of SFF's and 
are 6-20 bytes in length, To see what 
these look like, insert the system master 
disk and read track $00 as described 
above, 

Moving through the buffer with the 
arrow keys will reveal a large variety of 




values, Spaced among these should 
be sections of 6-20 FF's in a row, 
depending on the exact disk. Normally 
DOS 3.2 disks have larger gaps than 
DOS 3.3 disks. There should be many 
gaps, spaced so that one is seen about 
every other time the arrow keys are 
used to move forward or backward. 

Note: A second, smaller (2-5 SFF's) 
gap may be seen following a large 
gap, with a small section of data In- 
between. This is called the secondary 
gap. When referring to a gap here, the 
allusion will be to the primary gap, not 
the secondary one. 

Full/Half Tracks 

Now try looking at other tracks on the 
disk. First look only at the full tracks (no 
".5" on the end). All of them will be simi- 
lar to track $00 in the appearance of 
the gaps. Try this several times to 
become comfortable with locating 
gaps on a given track, 

Now read a half-track (",5" on the 
end), Scan memory to locate some of 
the gaps. Since System Master disks do 
not use half-tracks, the data which is 
seen is really 'cross-talk'. In other words, 
data was written on the full track, but 
the magnetic pattern spread out a bit, 
so some data is seen here. The tell-tale 
sign of this phenomenon is that the 
gaps will not all be the same. That is, 
they may contain one or more values 
which are inconsistent. This reveals that 
there Is some data on the track, but that 
It Is not valid data. Take a look at other 
half-tracks, until half-tracks and full 
tracks can be discerned by examining 
the gaps. 

Blank Tracks 

The next item to be able to identify is a 
blank track. To do this, Insert a blank 
(non-initialized) disk Into drive 1 . Read 
any track on this disk and scan through 
the memory addresses. There will be no 
gaps, and many of the bytes will end in 
"0" (IE. SAO, SB0, $E0), which are not 
legal disk bytes. This means that the 
controller can find no valid data on the 
track. Some disks have portions of 
tracks which are not used, so always be 
sure to examine at least 24 screens full 
of information to make sure that there Is 
no data at any point on the track. 
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The next tool for finding data is the 
fact that valid data must be at least 1 
track apart. In other words, if data is 
located on track 3.5, track 4 cannot 
have data and the next place where 
data can be is track 4,5. This is very 
helpful for finding tracks with data. 

Note: If data Is located on a given 
track, It is a good idea to look at the 
tracks one half-track to either side, to 
make sure that they look less valid than 
the track selected as the real one. 

Now that valid data can be recog- 
nized, begin at track S00 and step 
towards track $22. checking each track 
to see if it appears to have data on it. 
Most disks have a pattern to the position 
of the data, and If that pattern can be 
figured out it may be possible to just 
check a few tracks to make sure, and 
then go on to step 2, Otherwise the data 
must be located one track at a time. 

Most disks use the standard tracks 

[1,2,3 22], but there are some 

which use half-tracks and some which 
use track $23 (which cannot be read on 
all drives since Apple drives were not 
designed to go out that far). 

When all tracks which contain some 
type of data are located, go on to step 
2, 

Step 2: Find the Address Markers 

Now tell Nibbles Away ][ how to read 
the information on the tracks which 
have been found to contain valid data. 
This is done by going back to each of 
these tracks with the TBE and finding the 
address mark for each one. The 
address mark will be the first 3 bytes fol- 
lowing the gap. To see this in operation, 
take a look at a track from the System 
Master disk. After each gap either 'D5 
AA 96' for a DOS 3.3 Master disk, or 'D5 
AA 65' for a DOS 3.2 disk will be seen. 
These values should be noted along- 
side of each track number which con- 
tains data. Many times there will be only 
one, or maybe two patterns for all 
tracks, 

After this, these tracks can be copied. 
This is done by exiting the TBE (use "Q 1 ) 
and then selecting "M" for the modifiers 
menu. Then select "B" for Backup Modi- 
fier, When asked "USE ADDRESS MARK 1 , 
answer "Y" and then type in the 
address mark that was noted for the 
range of tracks to be copied. Simply 
press > return < to the rest of the ques- 
tions and then return to the main menu. 

Select "N" to enter Nibbles Away ][, 
and answer ,l Y" to the question 
"CHANGE DEFAULT OPTIONS," Use the 
> RETURN < key to move to the "START 
TRACK" prompt, and then enter the first 
track to be copied, Press >return< and 
then type in the last track to be copied 
with the current address marker setting. 

If the tracks in the specified range are 



not spaced at \ -track intervals, enter 
the interval at the "TRACK INCREMENT" 
prompt. Press > return < for the follow- 
ing questions, and begin the copy after 
inserting the disks (when prompted). 
After returning to the main menu, 
repeat the above procedure for each 
range of tracks which contains a differ- 
ent address marker, 

Now comes the moment of truth! Try to 
Boot the copy disk (if the original had a 
write-protect tab, the copy should tool]. 
If the copy boots, then all went success- 
fully 

Step 3: Determine Additional Protection 

If the back-up did not work properly, 
there areafew things to look for. 

1. . .Didallofthe tracks which should 
have copied do so? This can be seen 
while the copy takes place as a "Y" or 
an "N" under that track status location. 
If some did not, then the address 
marker was probably not determined 
properly. If this is the case, go back to 
the TBE and try those tracks again. 

2 ... If everything seemed to go well, 
but the copy refuses to work (it might 
helpto try the procedure again, maybe 
with the source and destination drives 
reversed, to make sure it was not a 
power glitch or other such occurrence 
which messed things up), the next step 
is to try the procedure with the "SYN- 
CHRONIZED COPY" option selected. 
Disks which use this method often make 
violent head movements during their 
boot procedure. This can be a clue to 
this type of protection. 

Additional Information: 

On some DOS 3.3 diskettes, the gaps 
between the sectors are reduced in 
size. In some cases they can be as small 
as 4 or 5 bytes. When Nibbles Away 
][finds the beginning of a section of 
data, it normally adds 8 bytes of sync 
just before the data. This will normally 
put sync bytes into the gap before the 
data, where it should be. However, if a 
disk has very small gaps, then the 
added sync can overwrite the end of 
the previous sector. The parameter FIX 
AMNT controls the number of sync bytes 
which are added, so this value can be 
reduced to prevent any data from 
being overwritten. The value that Nib- 
bles Away ][ uses for the sync which it 
puts in is contained in the parameter FIX 
VALU. Normally this is a $7F, but it can 
be set to any desired value. 

It should be noted that Nibbles Away 
][ regards any data byte which has its 
high bit cleared to be a sync byte. So 
the $7F which Is normally in this parame- 
ter means that a sync SFF is to be 
added. If the 'OVERIDE STANDARDIZER" 



option is selected, then Nibbles Away ][ 
will not add any bytes, it will simply con- 
vert the data which is present before a 
sector into sync, without changing its 
value, This technique can also be used 
for disks whose gaps are very small, 

Long Tracks 

Another item to watch for is disks 
whose tracks appear to be very long. 
Some disk protection schemes put gar- 
bage on a portion of the track. When 
this garbage is read back, more bytes 
are read in than were written out. This 
causes the track to be longer than nor- 
mal, and in some cases it becomes so 
long that the default parameters for 
Nibbles Away ][ cannot find the data 
properly 

DATA MIN/MAX 

The parameters DATA MIN and DATA 
MAX control the minumum and max- 
imum track lengths (in increments of 256 
bytes] which Nibbles Away ][ will 
accomodate. The normal value of DATA 
MAX is SID, but this can be set to a 
higher value, such as S25, if a track 
appears to be very long. Even though 
the track may read a large number of 
bytes, many of these will be removed 
by the Nibble Filter, since they are gar- 
bage bytes, This will assure that the 
amount of data written back will not be 
too large to fit on the destination track. 

When Nibbles Away ][ finds a sector of 
data, it looks ahead to find a second 
occurrence of the some pattern. This 
insures that the sector has been read 
and located correctly On many disks, 
there is a primary section of data, 
called the address field, and the the 
actual data field follows. In-between 
these is a small gap, which often con- 
tains random information. This means 
that Nibbles Away ][ should only match 
the number of bytes which are found in 
the address field, since the bytes in the 
gap may not read as the same value 
every time. 



FIND MAX 



The parameter FIND MAX controls the 
number of bytes which are checked 
during this procedure. The default 
value of SfflC works in most cases, but 
some disks use a smaller address field 
which may require this parameter to be 
set to a smaller value, However, if this 
parameter is set too low, then Nibbles 
Away ][ may identify the match for a 
section of data whose first few bytes are 
the same, but which differ later on, 
Therefore one should exercise caution 
when lowering this value. 
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CHR$(4)" HYPER D.QS. 



MENU 



continued from page 27 



9C91- C8 
«92- II FB 
?W4- ft JE 

9CW- 28 E9 9C 



9CW- ft* FF 
9C98- D8 El 
9C90- C8 
9C9E- Bl FB 
9CA3- M 03 
?CA2- 4C EA AZ 



INY 

ORA (PTRI.V 

m SKIP2 

JSR READ 



IF ANOTHER T/S LIST MUST BE READ IN FRDH THE BISK 



LDY TEMP 

BNE LOAD. IT 

W 

LDA (PTRt.Y 

BN£ NOT. 

JNP CLOSE 



9CA5- 8D 

9CA8- C8 

9CA9- 

9CAB 

9CAE 

9CB1 

9CB2 

9CB5 



EC B7 



SI FB 

8D ED B7 

F0 B7 



AD 
48 
AD FJ 



B7 



48 



9CB6- A5 FB 
9CB8- 8D H B7 
9CBB- A5 FC 
9CBD- 8B Fl B7 



2130 

2140 

2150 

2160 

2170 *-— 

2IB0 * SEE 

2190 #- — 

2200 

2210 

2220 

2230 

2240 

22S0 

2260 # 

2270 • READ ANOTHER T/S L 

2280 * 

2290 NOT. DONE STA M.TRK 
2300 INY 

2310 LDA IPfflJ.V 

2320 STA RN.SCT 

2330 LDA ftW.BUF 

2348 PHA 

2350 LDA RH.SUF+ 

2360 PHA 

2370 # 

2380 LDA PTR 
2398 STA RK.BUF 
2400 LDA PTR+I 



POINT TO SECTOR 
BOTH TRACK AND SECTOR 0? 
YES. SOTO PARTIAL READ ROUTINE 
NO, SO READ IN THE ENTIRE SECTOR 



SET T/S COUNTER 

IF NOT ZERO THEN EXIT 

GET TRACK OF T/S LIST 

IF IT ISN'T ZERO THEN READ IT IN 

OTHERWISE NE ARE DONE 



1ST 

SAVE TRACK NUMBER 

GET SECTOR NUMBER 
SAVE IT 

SAVE CURRENT BUFFER ADDRESS 
BY PUSHING THE ADDRESS 
I ONTO THE STACK 
AND 



RESET BUFFER TD NORMAL 
TO PREPARE FOR READING THE 
HEN T/S LIST 



2410 STA RH.BUFtl THEN 

continued on facing page 



continued from page 35 

575: if the first character of A$ is an 
asterisk (*), change the LOCK option to 
UNLOCKandsetthe LOCK flag (L = 1). 

580: Use the second character of A$ 
to set the file type flag. If it is binary, 
change the options from LOAD to 
BLOAD, RUN to BRUN, and set the Binary 
flag(B= 1). 

585: if the file type is Text, change RUN 
option to EXEC and set the Text flag (B = 
2). 

590-610: Print all options available. 
Do not print the LOAD option if the file is 
Text. 

615-630: Prepare for future errors and 
redefine AS as just the file name (the sta- 
tus is removed). 

650; GET choice. 

2) LOCK FILE (669-788) 

This routine will LOCK a file only If the 
user confirms the action and the LOCK 
flag is set. 

660: Check for the "K" command 
(LOCK). If not "K 1 , then go to routine 4 
(UNLOCK), 

continued on facing page 



REPLAY 



QUICK DEPENDABLE BACKUP 
COPIES FOR THE APPLE II 



Replay does not copy o disk, 
rather it copies o program execut- 
ing in memory The term totoi lood 
describes a program that fully 
loads into memory to execute. 

The original disk formatting is not 
important. If the program will boot, 
it is possible to moke a backup 
copy that executes in 1 5 seconds. 

The backup copy is in a different 
format. With the card comes an 
editor utility that operates under 
DOS 0.3. This allows editing of the 
copy disk. A second utility will pock 
the copy disk and put it into an 
executable DOS 3.3 binary file. 



• COPIES TOTAL LOAD PROGRAMS 

• DISK FORMATTING IRRELEVANT 

• COPY IN JUST 15 SECONDS 

• PROGRAM RESTART IN 1 
•TRANSPARENCY SWITCH 



COST CONFIGURATION 

J 129.95 Fully Assembled Card 

W/Utility EM 
£ 89.95 Kir (Wire Wrap) 
$59.95 EPROM Plus Schematic 




Add 5% soles tox in TEXAS plus $5.00 
shipping ond handling 

MASTER CARD/VISA ACCEPTED 

Moil & 

Texas Ranch and Shoreline 5ystems 

P.O. Box 20 

5712ManorRd. 

Austin, TX 76723 



Apple is a trademark of Apple computer, mc 
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670: Otherwise, confirm action 
(GOSU8 3O00). 

680: If the LOCK request is not con- 
firmed, go back to the Mini-Menu. 

690,700: If confirmation is given, 
LOCK the file and change file name 
NAS[X) to include an asterisk (*), Return 
to the main menu, 

3) CENTER PRINTING 

Lines 690-699 are similar in appear- 
ance to routines in each of the other 
sections, so it is numPerea "3" and will 
be referred to each time the same func- 
tion is performed. 

690: Center the text vertically. 

692, 694: Center the text horizontally 

699: Print the operation being per- 
formed (in this case the operation is 
LOCK) and perform that action. This is 
where major revisions will be found 
(compare lines 699, 745, 860, 979. and 
1100), 



4) UNLOCK FILE (718-760) 

This routine will UNLOCK a file only if 
the request is confirmed and the LOCK 
flag is not set. 

710; Check for the "U" command 
(UNLOCK]. If the LOCK flag is set or the 
"U" command was not entered, go to 
routine 5 (RUN/BRUN). 

720; If so and the LOCK flag is not set, 
confirm the action (GOSUB 3000). 

740: Let us know what's going on (see 
routine 3), then return to main menu. 

5) RUN/BRUN FILE (765-809) 

765: If the "R" command (RUN/BRUN) 
was not entered, continue to routine 7 
(LOAD/BLOAD). 

770: Set the DOS command to BRUN 
(C$ = "BRUN'), 

800: If the binary flag is zero, set the 
DOS command to RUN (C$ = "RUN') 
and go to routine 6 (DOS CONTROL). 



swactoaBStecesaafeaaewweiaswasaa Mssaao wgaaawaaw 



ww>ww»wwww 
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SSK 



9CC8- 

?CC3- 
?CM- 
?CC7- 
9CC8- 

9CCB- 

9CCD- 

?CCF- 
?CD1- 
9CD2- 

9CBA- 
?CD7- 
9CDS- 
9CD8- 
9CDE- 
9CE1- 
9CE3- 
9CE6- 



9CE9- 
?C£B- 
9CEE- 
9CF1- 
9CF4- 
9CF6- 

9CF7- 
9CF8- 
?CF9- 
9CFB- 



242« *- 
28 E9 9C 2432 

2448 *- 
68 2450 
80 Fl B7 2468 
68 2478 
3D F8 B7 2488 

2498 *- 



JSR READ 



READ IN THE NEN TRACK /SECTOR 



PLA RECOVER THE CURRENT BUFFER flCDR 
STfl RH.BUF+l BY PULLING IT OFF 
PLA THE STACK 
STA RH.BUF 



88 2A 
A2 K 
84 FF 
B8 
58 AA 

AD 68 
18 

68 F9 
3D 38 
20 E9 
A9 M 
8D 3D 
4C EA 



2508 
2518 
2520 
2538 
2548 
2550 *- 



BCS EX. ERR CARRY IS 5ET IF AN ERROR OCCURED 

LDY l»K SET YfiEG TO POINT TO FIRST T/S 

STY TEHP SAVE IT 

CLV SET UP FOR BRANCH ALWAYS 

BVC LOAD. IT ALWAYS TAKEN 



A9 00 
8D EB 
28 E3 
28 B5 
B8 01 
60 

68 
68 

A2 88 
4C 02 



AA 2560 SKIP2 

2570 
B7 2580 
BE 2590 
9C 2600 

2610 
BE 2628 
A2 2638 

2640 t— — 

2652 * READ 

2662 * 

2670 READ 
B7 2680 
83 2698 
B7 2780 

2712 

2720 

2732 * 

2740 EI. ERR 

2750 

2768 
A7 2770 

27B0 * 



LDA F.LEN 
CLC 

ADC OFFSET 
STA *BE3D 
JSR READ 
LDA tf00 
STA $BE3D 
JNP CLOSE 



SET NUMBER OF BYTES IN LAST SECTOR 
SET UP FOR ADDITION 

SET UP FOR PARTIAL DECODE 
READ IN PARTIAL SECTOR 
RESET NiBBLIZINE ROUTINE 

CLOSE FILE 



IN A TRACK AM) SECTOR, CARRY SET IF ERROR OCCURS 



LDA 1*02 SET VOLUME NUMBER TO ZERO 
STA RUTS. VOL SO WE CAN READ FROM ANY DISK. 
JSR 10B.L0C GET I0B LOCATION UN DOS) 
JSR SITS CALL DOS TO READ IN THE T/S 
BCS EX.ERR IF NO ERROR THEN RETURN 
RTS 



PLA AN ERROR HAS OCCURED 

PLA SO RESET THE STACK 

LOX 1488 AND PRINT THE ERROR 

JNP PRT.ERR PRINT "I/O ERROR" 



SYWOL TABLE 

AA72- B.ADDR 
9C1F- BLOAD 
A2EA- CLOSE 
B5CB- DA.BL1F 



A471- END.LD 
9CF7- EK.ERR 
9C16- EXIT 
AA68- F.LEN 
03E3- I0B.L0C 
9C01- LOAD 
9C7E- LOAD. IT 



9C54- LOOP! 
B7FA- NOV. NUN 
9CA5- NOT. DONE 
B7F9- OFFSET 
A782- PRT.ERR 
00FB- PTR 
02FD- PTR2 



9CE9- 
B7F8- 
B7ED- 
B7EC- 
B7B5- 
B7EB- 
9C41- 



READ 

RW.BOF 

RW.SCT 

RN.TfiK 

R«TS 

RITS.VOL 

SCT.LD 



9CD4- SKIP2 
0267- START 
08FF- TEflP 
B5C9- TS.BUF 



6) DOS CONTROL (81 0-890) 

This routine has two entry points: 

A. OPTIONAL ADDRESS (line 810) 

8, DEFAULT ADDRESS (line 830) 

Line 810 will ask where to put the file 
(for BRUN or BLOAD). If the 
>RETURN<key is pressed, the binary 
program will default to its normal loca- 
tion. If a different location is desired, 
then enter that location (in hex or deci- 
mal). A hex location MUST be preceded 
by a dollar sign ($). 

Enter at line 820 to bypass the 
optional BLOAD/BRUN address. 

To enter either routine, CS must equal 
the DOS command that is associated 
with the desired action and AS must be 
equal to the file name . To enter the sec- 
ond routine, LS and BS must both be 
cleared. 

820: Control the default address for 
Binary files. 

830: Get confirmation of the action to 
be performea (GOSUB 3000). 

840: if confirmation is not given, go 
back to the Mini-Menu. 

850-880: if confirmation is given, print 
the action (see routine 3) and call DOS 
to do it. 

continued on next page 



DOUBLE 
your 

DISKETTES 

The only reasons your Apple ][ 
cannot use the back side of your 
diskette are: 

1. There is no notch 

2. The diskette manufacturer did 
not test the back side, or worse, 
put the flawed front to the hack. 

A nibbling tool will solve problem 
number 1. 

DISK PREP will solve problem 
number 2. 

DISK PREP formats and tests your 
disk. Sectors with flaws are left so 
that they cannot be used. Your disk 
is left ready to boot, complete with a 
flaw report program saved on it. 

$25.00 

sympathetic software 

9531 Telhan Drive 

Huntington Beach, CA 92646 

California residents add 

$1.50 sales tax 

Dealer inquiries invited 
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continued from page 71 



890: Return to the main menu, 

7) LOAD/BLOAO FILE (900-930) 

900: Check for the "L" command 
(LOAD or BLOAD), If not "L\ go to routine 
8 (DELETE). 

91(0: Otherwise, set the default to 
BLOAD. 

920: If the binary flag is clear (B is not 
equal to 1), change to LOAD (C3 = 
"LOAD') and enter routine 6 (DOS Con- 
trol) at the second entry point (line 820], 

930: If the binary flag is set, enter rou- 
tine 6 at the first entry point (line 810). 

6) DELETE FILE (940-980) 

940: Check for the "D" command 
(DELETE). If not "D', go to routine 9 
(RENAME). 

950: Otherwise, check the LOCK flag 
to see if the file Is locked. If so, issue a 
warning (THIS FILE IS LOCKED), 

960: Confirm action (GOSUB 3000). 

965: If confirmation is not received, 
then return to the Mini-Menu. 

970; If confirmation is received, cen- 
ter the text (see routine 3) and UNLOCK 
the file (in case it was locked), then 
DELETE it. 

980: Re-start the program. 

9) RENAME FILE (998-1120) 

990: Check for the "C" command 



(RENAME). If not "C\ go to routine 10 
(UNLOCK/LOCK ALL). 

1010: Otherwise, check the LOCK flag 
to see if the file is locked. If it is, print a 
warning message. 

1030: Confirm action (GOSUB 3000). 

1050: If confirmotion is not received 
return to the Mini-Menu, 

1070: Otherwise, INPUT a new file 
name. 

1075: If the file name Is greater than 
thirty characters print an error message 
and go back to the Mini-Menu. 

1080: If the new name is nothing 
(RETURN was pressed), then return to the 
Mini-Menu, 

1090-1100: Center the text (see rou- 
tine 3) and do the required action. 

11 10: LOCK the file if the old file name 
was locked (check the LOCK flag). 

1115: Redefine the old file name, 
NA$(X), to be the first seven characters 
(status) of the old file name plus the new 
name. 

1120; Return to the main menu, 

10) LOCK/UNLOCK ALL (1 160-1270) 

This routine will allow us to UNLOCK or 
LOCK ALL of the files on the disk. 

1160: If "A" was not selected, go to 
routine 11 (EXIT?). 

1170: Otherwise, get the choice 
(LOCK or UNLOCK). 

1180: If the "L" or "U" key is not 
pressed, go bock to the Mini-Menu. 
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1190, 1200: Depending upon 
whether "U" or "L" was pressed, set the 
DOS command to LOCK or UNLOCK, 

1210: Center the text (see routine 3). 

1220-1260: Run through a loop per- 
forming the DOS action (LOCK or 
UNLOCK) and modifying each file 
name, NA$(X], to contain an asterisk 
(locked) or a blank (unlocked) depend- 
ing on the action taken, 

1230: When a file consisting of " = 's is 
found, exit to the main menu. 

11) EXIT MINI-MENU (1280) 

1280: If the "X', CTRL "X, RETURN or 
ESC key is pressed, go back to the main 
menu. Otherwise go to routine 12 
(EXEC). 

12) EXEC TEXT FILE (1282-1300) 

1282; If the "E" command Is not 
selected or if the Text flag isn't set (B is 
NOT equal to 2), then go to the Mini- 
Menu. 

1 284: Otherwise set DOS command to 
EXEC (CS = 'EXEC 1 ), and clear L$ and BS . 
Go to the second entry point in routine 6 
(line 830). 

- ERROR CONTROL - 

Control of error messages is done with 
ONERR GOTO's. Depending upon 
where the ERRor occurred, these are 
the responses: 

A. ERR IN NEW NAME. PLEASE TRY 
AGAIN 

1310-1340; The new name of a file 
(change command) Is illegal. LOCK the 
file and print message. Return to the 
Mini-Menu. 

B. Ill -UNABLE TO READ DIRECTORY II! 
1350-1360: DOS was unable to read 

the disk, probably an I/O ERROR. Print 
message and exit the program. 

C. ERR IN LOAD ADDRESS 

1370; A bad LOADing address (used 
in BLOAD/BRUN command). Print the 
message to the screen and go to line 
1340 to get a keypress. Re-enter the 
Mini-Menu, 

D. STRANGE ERR. I WILL RE-READ THE 
CATALOG 

1380: A strange error was encoun- 
tered, so re-read the catalog. Go back 
to the hard entry point (line 55). 

-PRINT HELP (3010-3080)- 

3010-3080: Print the instructions for the 
help mode (invoked by pressing the 
ESC key when in the main menu). 

- CONFIRMATION OF ACTION (3000) 

3000; Asks for Y or N in order to con- 
firm an important DOS action. 
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Hardcore Computing is splitting into two magazines. See the back cover for 
more information... 
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CORRECTIONS FOR ISSUE #3 

NOTE: This is a reprint of Volume 1, Issue 1 of Hardcore Computing. The 
following are corrections to that issue. 

Page 1 - Table of Contents - VISICALC: "Job Costing" appears on page 51 
instead of page 41. "HGR: Huey's Hi-Res Corner" appears on page 43 instead 
of page 42. 

. Page 24 - "Relief Map-Editor" - first column, step 3. 

Change-. 10040 AA = BB : BB = BMEM% + 399 : = AA TO BB STEP 20 : GOSUB 
11000 : NEXT IN 

To: 10040 AA = BB : BB = BMEM* + 399 : TEST = MAX : GAP = -1 FOR IN = 

AA TO BB STEP 20 : GOSUB 11000 : NEXT IN. 

Page 33 - "Menu" - The machine language listing in the first column is 
correct, but to make line identical to the sample line change the two 
FF's in line 828 to B2 84 by typing: 
82C:B2 84 

When setting the "end of program" counter, make sure you type a space 
between the 3A and #8. 

Page 40 - "Zephyr Wars" - Insert line 200: 

200 ROT=0:X% = XUFO*(Z> * 1:1% = YUFO%(Z): IF XH = THEN RETURN 

Page 46 - "Vector Graphics" - Line 210 should read: 
210 IF A<0 THEN 250 

Page 72 - "Bugs" ~ This section should read: For those of you who have 
the magazine version of TEXT INVADERS, make this change to line 970 and it 
will stop crashing after you wipe out the first row of invaders: 

97$ INVADERS* U> = LEFTS < INVADERS* (1 > , RAN*;) + TEMPS* + MID$ 
(INVADERSS (AA), RAN% +2) 

Also, for those with DiskView 1.1, there is a bug in line 690^ of the 
"print routine." Please change line 690 to read: 
690 PT = KY*: RETURN 
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Hardcore Computing has become two magazines: CORE and HARDCORE 
COMPUTIST. CORE will be a quarterly magazine, and each 
issue will focus on a different topic. HARDCORE COMPUTIST 
will be published the other eight months, and will be 
devoted to articles about unlocking copy-protected discs 
and other advanced subjects. Four issues of CORE and eight 
issues of HARDCORE COMPUTIST will be included in a single 
$20 subscription. Use the coupon on page 3 to subscribe to 
both magaz i nes . 



